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About the Tutorial 


PyQt5 is the latest version of a GUI widgets toolkit developed by Riverbank Computing. It 
is a Python interface for Qt, one of the most powerful, and popular cross-platform GUI 
library. PyQt5 is a blend of Python programming language and the Qt library. This 
introductory tutorial will assist you in creating graphical applications with the help of PyQt. 
Our tutorial on earlier version - PyQt4 is available here. 


Audience 


This tutorial is designed for software programmers who are keen on learning how to 
develop graphical applications using PyQt. 


Prerequisites 


You should have a basic understanding of computer programming terminologies. A basic 
knowledge of Python programming is a desirable. 


Copyright 8. Disclaimer 


O Copyright 2020 by Tutorials Point (1) Pvt. Ltd. 


All the content and graphics published in this e-book are the property of Tutorials Point (1) 
Pvt. Ltd. The user of this e-book is prohibited to reuse, retain, copy, distribute or republish 
any contents or a part of contents of this e-book in any manner without written consent 
of the publisher. 


We strive to update the contents of our website and tutorials as timely and as precisely as 
possible, however, the contents may contain inaccuracies or errors. Tutorials Point (1) Pvt. 
Ltd. provides no guarantee regarding the accuracy, timeliness or completeness of our 
website or its contents including this tutorial. If you discover any errors on our website or 
in this tutorial, please notify us at contactOtutorialspoint.com 
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1. PyQt5 — Introduction 


PyQt is a GUI widgets toolkit. It is a Python interface for Qt, one of the most powerful, 
and popular cross-platform GUI libraries. PyQt was developed by RiverBank Computing 
Ltd. PyQt5 is the latest version. It can be downloaded from its official website 
— riverbankcomputing.com. 


PyQt API is a set of modules containing a large number of classes and functions. 
While QtCore module contains non-GUI functionality for working with file and directory 
etc., QtGui module contains all the graphical controls. In addition, there are modules for 
working with XML (QtXml), SVG (QtSvg), and SQL (QtSql), etc. 


A list of frequently used modules is given below: 


e QtCore: Core non-GUI classes used by other modules 

e  QtGui: Graphical user interface components 

e QtMultimedia: Classes for low-level multimedia programming 
e. QtNetwork: Classes for network programming 

e. Qt0penGL: OpenGL support classes 

e QtScript: Classes for evaluating Qt Scripts 

e QtSql: Classes for database integration using SQL 

e. QtSvg: Classes for displaying the contents of SVG files 

e. QtWebKit: Classes for rendering and editing HTML 

e QtXml: Classes for handling XML 

e. QtWidgets: Classes for creating classic desktop-style Uls 
. QtDesigner: Classes for extending Qt Designer 


Supporting Environments 


PyQt is compatible with all the popular operating systems including Windows, Linux, and 
Mac OS. It is dual licensed, available under GPL as well as commercial license. The latest 
stable version is PyQt5-5.13.2. 


Windows 


Wheels for 32-bit or 64-bit architecture are provided that are compatible with Python 
version 3.5 or later. The recommended way to install is using PIP utility: 


pip3 install PyQt5 


To install development tools such as Qt Designer to support PyQt5 wheels, following is the 
command: 


pip3 install pyqt5-tools 
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You can also build PyQt5 on Linux/macOS from the source code: 


https://www.riverbankcomputing.com/static/Downloads/PyQt5/5.13.2/PyQt5- 
5:13,2,tar.0z 
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2. PyQt5 — What's New 


PyQt5 API is not automatically compatible with earlier versions. Hence, Python code 
involving PyQt4 modules should be upgraded manually by making relevant changes. In 
this chapter, main differences between PyQt4 and PyQt5 have been listed. 


PyQt5 is not supported on versions of Python earlier than v2.6. 


PyQt5 doesn't support connect() method of QObject class for connection between signal 
and slot. Hence the usage can no more be implemented: 


Q0bject.connect(widget, QtCore.SIGNAL(“signalname” ), slot_function) 


Only the following syntax is defined: 


widget.signal.connect(slot_function) 


Classes defined in earler QtGUI module have been distributed 
in QtGui, QtPrintSupport an QtWidgets modules. 


In the new QFileDialog class, The getOpenFileNameAndFilter() method is replaced 
by getOpenFileName(), getOpenFileNamesAndFilter() by getOpenFileNames() 
and getSaveFileNameAndFilter() by getSaveFileName(). Older signatures of these 
methods also have changed. 


PyQt5 doesn't have provision to define a class that is sub-classed from more than one Qt 
class. 


pyuic5 utility (to generates Python code from Designer's XML file) does not support the - 
-pyqt3-wrapper flag. 


pyrcc5 does not support the -py2 and -py3 flags. The output of pyrcc5 is compatible with 
all versions of Python v2.6 onwards. 


PyQt5 always invokes sip.setdestroyonexit() automatically and calls the C++ destructor 
of all wrapped instances that ¡it owns. 
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3. PyQt5 — Hello World 


Creating a simple GUI application using PyQt involves the following steps: 


e Import QtCore, QtGui and QtWidgets modules from PyQt5 package. 
e Create an application object of QApplication class. 

e. A QWidget object creates top level window. Add QLabel object in it. 
e  Setthe caption of label as "hello world". 

e Define the size and position of window by setGeometry() method. 

e Enter the mainloop of application by app.exec_() method. 


Following is the code to execute Hello World program in PyQt: 


import sys 
from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 
def window(): 

app = QApplication(sys.argv) 
= Quidget() 
QLabel(w) 
.setText("Hello World!") 


COTO. z 
Il 


w.setGeometry(100,100,200,50) 
b.move(50,20) 
w.setWindowTitle("PyQt5") 
w.show() 


sys.exit(app.exec_()) 


if _ name__ == '_ main_': 


window () 


The above code produces the following output: 


It is also possible to develop an object oriented solution of the above code. 


e Import QtCore, QtGui and QtWidgets modules from PyQt5 package. 
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e Create an application object of QApplication class. 

e Declare window class based on QWidget class 

e Add a QLabel object and set the caption of label as "hello world”. 
e Define the size and position of window by setGeometry() method. 


e Enter the mainloop of application by app.exec_() method. 


Following is the complete code of the object oriented solution: 


import sys 

from PyQt5.QtCore import * 

from PyQt5.QtGui import * 

from PyQt5.QthWidgets import * 

class window(QWidget): 

def init (self, parent = None): 

super(window, self). _ init_ (parent) 
self.resize(200,50) 
self.setWindowTitle("PyQt5") 
self.label = QLabel(self) 
self.label.setText("Hello World”) 
font = QFont() 
font.setFamily("Arial") 
font.setPointSize(16) 
self.label.setFont(font) 
self.label.move(50,20) 


def main(): 
app = QApplication(sys.argv) 
ex = window() 
ex.show() 


sys.exit(app.exec_()) 


if  name__ == ' main_': 
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4. PyQt5 — Major Classes 


PyQt API ¡is a large collection of classes and methods. These classes are defined in more 
than 20 modules. 


Following are some of the frequently used modules: 
ETA di 
QtCore 
Core non-GUI classes used by other modules 
QtGui 
Graphical user interface components 
QtMultimedia 
Classes for low-level multimedia programming 
QtNetwork 
Classes for network programming 
QtOpenGL 
OpenGL support classes 
QtScript 


Classes for evaluating Qt Scripts 


QtSql 


Classes for database integration using SQL 


QtSvg 
Classes for displaying the contents of SVG files 


QtwWwebKit 

Classes for rendering and editing HTML 
QtXml 

Classes for handling XML 

QtWidgets 

Classes for creating classic desktop-style Uls. 
QtDesigner 


Classes for extending Qt Designer 
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QtAssistant 


Support for online help 


PyQt5 development tools is a collction of useful utilities for Qt development. Following is a 


select list of such utilities: 


Qt Assistant documentation tool 


pyat5designer Qt Designer GUI layout tool 


linguist Qt Linguist translation tool 


update ts files 


pyaqmlviewer QML file viewer 


pyuic5 Qt User Interface Compiler for generating code 
from ui files 


pyaqmltestrunner running unit tests on QML code 


QDoc documentation  genearator for software 
projects. 


Qhelpgenerator generating and viewing Qt help files. 
qmlimportscanner parses and reports on QML imports 


PyQt API contains more than 400 classes. The QObject class is at the top of class 
hierarchy. It is the base class of all Qt objects. Additionally, QPaintDevice class is the 
base class for all objects that can be painted. 


QApplication class manages the main settings and control flow of a GUI application. It 
contains main event loop inside which events generated by window elements and other 
sources are processed and dispatched. It also handles system-wide and application-wide 
settings. 


QWidget class, derived from QObject and QPaintDevice classes is the base class for all 
user interface objects. QDialog and QFrame classes are also derived from QWidget class. 
They have their own sub-class system. 


Here is a select list of frequently used widgets: 
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ESE Widgets €: Description 


QLabel 

Used to display text or image 

QLineEdit 

Allows the user to enter one line of text 
QTextEdit 

Allows the user to enter multi-line text 
QPushButton 

A command button to invoke action 
QRadioButton 

Enables to choose one from multiple options 
QCheckBox 

Enables choice of more than one options 
QSpinBox 

Enables to increase/decrease an integer value 
QScrollBar 

Enables to access contents of a widget beyond display aperture 
QSlider 

Enables to change the bound value linearly. 
QComboBox 

Provides a dropdown list of items to select from 
QMenuBar 

Horizontal bar holding QMenu objects 
QStatusBar 

Usually at bottom of QMainWindow, provides status information. 


QToolBar 


Usually at top of QMainWindow or floating. Contains action buttons 


QListView 


Provides a selectable list of items in ListMode or IconMode 


. 
- 
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QPixmap 


Off-screen image representation for display on QLabel or QPushButton object 


QDialog 


Modal or modeless window which can return information to parent window 


A typical GUI based application's top level window is created by QMainWindow widget 
object. Some widgets as listed above take their appointed place in this main window, while 
others are placed in the central widget area using various layout managers. 


The following diagram shows the QMainWindow framework: 


¡Window Title Sit 


Menu Bar 


Toolbar Areas 


Dock Window Areas 


Central Widget 


Status Bar 


10 


tutorialspoint 


AS YLEARNING 


5. PyQt5 — Using Qt Designer 


The PyQt installer comes with a GUI builder tool called Qt Designer. Using its simple drag 
and drop interface, a GUI interface can be quickly built without having to write the code. 
It is however, not an IDE such as Visual Studio. Hence, Qt Designer does not have the 
facility to debug and build the application. 


Start Qt Designer application which is a part of development tools and installed in scripts 
folder of the virtual environment. 


E Ot Designer sE O Xx 
File Edit Form View Settings Window Help 


DADO ARA MSMT EEN 


Widget Box 5 
Filter 
Y Layouts A 


= Vertical Layout 
100 Horizontal Layout 
8383 Grid Layout 

Form Layout 
-Spacers 
[ad] Horizontal Spacer 
E Vertical Spacer 


v 


v Buttons 

Push Button ion Editor 

SN 1001 Button A sE 5 > - 
(O Radio Button DIA LOs. lee 


HA Check Box 
Q Command Link Button 


Dialog Button Box 


Y Item Views (Model-Based) 


List View 


Start designing GUI interface by chossing File -> New menu. 
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Y New Form - Qt Designer X 


x templatesiforms 
Dialog with Buttons Bottom 
Dialog with Buttons Right 
Dialog without Buttons 
Main Window 
Widget 
v Widgets 

QDockWidget 

OFrame 

QOGroupBox 

OscrollArea 

QMdiArea 

QTabWidget 

QToolBox 

OStackedWidget Embedded Design 

QWizard 

QWizardPage 


Device: None 


Screen Size: 'Default size Ñ y! 


Show this Dialog on Startup 


5) a] a 


You can then drag and drop required widgets from the widget box on the left pane. You 
can also assign value to properties of widget laid on the form. 
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1 Ot Designer 


File Edit Form View Settings Window Help 


JE 0 ARA Mm = 


Dialog Button Box 


> Item Views (Model-Based) 


> Itern Widgets (Item-Based) 


> Containers 


Input Widgets 


= Combo Box 


Z Font Combo Box 
Line Edit 


(AT) Text Edit 


(AI) Plain Text Edit 


[13 Spin Box 


ES] Double Spin Box 


Object Class 


v BÉ Form QWidget 
label OlLabel 
la..._2 QLabel 
la..._3 QLabel 
li... CAmieEda 


AA E 


TJ = % 

llabel : QLabel 

Property Value 

> text Physics 
textF j AutoText | 


(O TimeEdit 

EÍ) Date Edit 

8 Date/Time Edit 

9 Dial 

Horizontal Scroll Bar 
Vertical Scroll Bar 
+ Horizontal Slider 


Signal 


The designed form is saved as demo.ui. This ui file contains XML representation of widgets 
and their properties in the design. This design is translated into Python equivalent by using 
pyuic5 command line utility. This utility is a wrapper for uic module of Qt toolkit. The usage 
of pyuic5 is as follows: 


pyuic5 -x demo.ui -o demo.py 


In the above command, -x switch adds a small amount of additional code to the generated 
Python script (from XML) so that it becomes a self-executable standalone application. 


if _name__ == "_ main__ 
import sys 
app = QtGui.QApplication(sys.argv) 
Dialog = QtGui.QDialog() 

= Vi_Dialog() 

ui.setupUi(Dialog) 
Dialog.show() 
sys.exit(app.exec_()) 


The resultant python script is executed to show the following dialog box: 


python demo.py 
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Physics 


Maths | | 


Add 


Total 


The user can input data in input fields but clicking on Add button will not generate any 


action as it is not associated with any function. Reacting to user-generated response is 
called as event handling. 
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6. PyQt5 — Signals € Slots 


Unlike a console mode application, which is executed in a sequential manner, a GUI based 
application is event driven. Functions or methods are executed in response to user's 
actions like clicking on a button, selecting an item from a collection or a mouse click etc., 
called events. 


Widgets used to build the GUI interface act as the source of such events. Each PyQt widget, 
which is derived from QObject class, is designed to emit *signal' in response to one or 
more events. The signal on its own does not perform any action. Instead, it is *'connected” 
to a'slot'. The slot can be any callable Python function. 


Using Qt Designer's Signal/Slot Editor 


First design a simple form with a LineEdit control and a PushButton. 


It is desired that if button is pressed, contents of text box should be erased. The QLineEdit 
widget has a clear() method for this purpose. Hence, the button's clicked signal is to be 
connected to clear() method of the text box. 


To start with, choose Edit signals/slots from Edit menu (or press F4). Then highlight the 
button with mouse and drag the cursor towards the textbox 
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As the mouse is released, a dialog showing signals of button and methods of slot will be 
displayed. Select clicked signal and clear() method 


1D] Configure Connection - Qt Designer 


pushButton (QPushButton) lineEdit (QLineEdit) 


clicked() 
clicked(bool) 
pressed() 
released() 
toggledíbool) 


Edit... 


[] Show signals and slots inherited from QWidget 


The Signal/Slot Editor window at bottom right will show the result: 
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Signal/Slot Editor e xXx 
=p Ca 

Sender Signal Receiver Slot 

| pushButton clicked() lineEdit clear() 


Signal/Slot Editor Action Editor Resource Browser 


Save ui and Build and Python code from ui file as shown in the below code: 


pyuic5 -x signalslot.ui -o signalslot.py 


Generated Python code will have the connection between signal and slot by the following 
statement: 


self.pushButton.clicked.connect(self.lineEdit.clear) 


Run signalslot.py and enter some text in the LineEdit. The text will be cleared if the button 
is pressed. 


Building Signal-slot Connection 


Instead of using Designer, you can directly establish signal-slot connection by following 
syntax: 


widget.signal.connect(slot_function) 


Suppose if a function is to be called when a button is clicked. Here, the clicked signal is to 
be connected to a callable function. It can be achieved in any of the following technique: 


button.clicked.connect(slot_function) 


Example 


In the following example, two QPushButton objects (b1 and b2) are added in QDialog 
window. We want to call functions b1_clicked() and b2_clicked() on clicking bi and b2 
respectively. 


When bl is clicked, the clicked() signal is connected to b1_clicked() function: 


b1.clicked.connect(b1_clicked()) 


When b2 is clicked, the clicked() signal is connected to b2_clicked() function. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 
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def wi 
app 
win 
b1 
b1. 
b1. 
b1. 


b2 

b2. 
b2. 
b2. 


win. 


win. 
win. 


syS. 


def b1 


pri 


ndow(): 

= QApplication(sys.argv) 

= QDialog() 

= QPushButton(win) 
setText("Button1") 
move(50,20) 
clicked.connect(b1_clicked) 


= QPushButton(win) 
setText("Button2") 
move(50,50) 
clicked.connect(b2_clicked) 


setGeometry(100,100,200,100) 
setWindowTitle("PyQt5") 
show() 


exit(app.exec_()) 


_clicked(): 
nt ("Button 1 clicked”) 


def b2_clicked(): 


pri 


if on 


win 


nt ("Button 2 clicked”) 


ame__ == '_ main_': 


dow( ) 


The above code produces the following output: 
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Output 


Button 1 clicked 
Button 2 clicked 
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7. PyQt5 — Layout Management 


A GUI widget can be placed inside the container window by specifying its absolute 
coordinates measured in pixels. The coordinates are relative to the dimensions of the 
window defined by setGeometry() method. 


setGeometry() syntax 


The following is the syntax of setGeometry(): 


Quidget.setGeometry(xpos, ypos, width, height) 


In the following code snippet, the top level window of 300 by 100 pixels dimensions is 
displayed at position (50,20) on the monitor. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 


def window(): 
app = QApplication(sys.argv) 
w = QWidget() 


o 
I 


= QPushButton(w) 
.setText("Hello World!") 
b.move(50,20) 


o 


w.setGeometry(100,100,300,100) 
w.setWindowTitle('PyQt5 Window' ) 
w.show() 

sys.exit(app.exec_()) 


if _ name__ == '_ main_': 


window() 


A PushButton widget is added in the window and placed at a position 50 pixels towards 
right and 20 pixels below the top left position of the window. 


This Absolute Positioning, however, is not suitable because of the following reasons: 


e The position of the widget does not change even if the window is resized. 
e. The appearance may not be uniform on different display devices with different 
resolutions. 


e  Modification in the layout is difficult as it may need redesigning the entire form. 
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57 PyQt5 Window — [| X | EE PyQt5 Window - |) Xx 


Hello World! Hello World! 


PyQt API provides layout classes for more elegant management of positioning of widgets 
inside the container. The advantages of Layout managers over absolute positioning are: 


e Widgets inside the window are automatically resized. 
e  Ensures uniform appearance on display devices with different resolutions. 


e  Adding or removing widget dynamically is possible without having to redesign. 


Qt toolkit defines various layouts that can be used with Qt Designer utility. 


Qs Designer = a x 
El 


Ele Edr Farm View Settings Vóndow Help 


DE py 2 NE: 1 


Widget Box 8x Object Inspector 
pe Layouts | Object Class 


3 Vertical Layout 
ayort 
o 0: - Layout Managers : - 
El o 
4 Fon 


1163 
| 
x 


Property Editor ax 


Item Views (Model-Based) 
htern Widgets (Rern-Based) 
Contemers 
Input Widgets 
Display Widgets 


Here is the list of Classes which we will discuss one by one in this chapter. 


[Esas Classes 8 Description 


QBoxLayout 


QBoxLayout class lines up the widgets vertically or horizontally. Its derived classes 
are QVBoxLayout (for arranging widgets vertically) and QHBoxLayout (fo 
arranging widgets horizontally). 


QGridLayout 


A GridLayout class object presents with a grid of cells arranged in rows and columns. 
he class contains addWidget() method. Any widget can be added by specifying 
the number of rows and columns of the cell. 


O Layout 
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QFormLayout is a convenient way to create two column form, where each row 
consists of an input field associated with a label. As a convention, the left column 


contains the label and the right column contains an input field. 


QBoxLayout 


QBoxLayout class lines up the widgets vertically or horizontally. Its derived classes are 
QVBoxLayout (for arranging widgets vertically) and QHBoxLayout (for arranging 
widgets horizontally). Following table shows the important methods of QBoxLayout class: 


Methods €: Description 
addWidget() 
Adds a widget to the BoxLayout 
addStretch() 
Creates empty stretchable box 


addLayout() 


Adds another nested layout 


Example 1 


Here two buttons are added in the vertical box layout. A stretchable empty space is added 
between them by addStretch() method. Therefore, if the top level window is resized, the 
position of buttons automatically gets relocated. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


def window(): 
app = QApplication(sys.argv) 
win = QWidget() 


b1 = QPushButton("Button1") 
b2 = QPushButton("Button2") 


vbox = QVBoxLayout() 
vbox.addWidget(b1) 
vbox.addStretch() 
vbox.addWidget(b2) 
win.setLayout(vbox) 


win.setWindowTitle("PyQt") 
win.show() 
sys.exit(app.exec_()) 


if  name__ == ' main_': 
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window( ) 


The above code produces the following output: 
Mm py0t — O X m*' PyQt =ñ O X 


Button1 Button1 


Button2 


original window 


Button2 


resized window-position and size changed dynamically 


Example 2 


This example uses horizontal box layout. addStretch() method inserts a stretchable 
empty space between the two button objects. Hence, as the window is resized, the size 
and position of the button changes dynamically. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


def window(): 
app = QApplication(sys.argv) 
win = QWidget() 


b1 
b2 


QPushButton("Button1") 
QPushButton("Button2") 


hbox = QHBoxLayout() 


hbox.addWidget(b1) 
hbox.addStretch() 
hbox.addWidget(b2) 
win.setLayout(hbox) 
win.setWindowTitle("PyQt") 
win.show() 
sys.exit(app.exec_()) 

if  name__ == ' main_': 
window( ) 


The above code produces the following output: 
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A PyQt - O X ñ* PyOt - O X 


Button1 Button2 


original window 
Button1 Button2 


resized window. position and size change dynamically 


Example 3 


This example shows how the layouts can be nested. Here, two buttons are added to vertical 
box layout. Then, a horizontal box layout object with two buttons and a stretchable empty 
space is added to it. Finally, the vertical box layout object is applied to the top level window 
by the setLayout() method. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


def window(): 
app = QApplication(sys.argv) 
win = QWidget() 


b1 = QPushButton("Button1") 
b2 = QPushButton("Button2") 


vbox = QVBoxLayout() 
vbox.addWidget(b1) 
vbox.addStretch() 
vbox.addWidget(b2) 
hbox = QHBoxLayout() 


b3 = QPushButton("Button3") 
b4 = QPushButton("Button4") 
hbox.addWidget(b3) 
hbox.addStretch() 
hbox. addWidget(b4) 


vbox.addStretch() 
vbox.addLayout(hbox) 
win.setLayout(vbox) 


win.setWindowTitle("PyQt") 
win.show() 
sys.exit(app.exec_()) 
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if _ name__ == '_main_': 
window( ) 


The above code produces the following output: 


np —- Oo. X 1] pyot ==. x 
Button1 Button1 
Button2 
Button3 Button4 
original window Button2 
Button3 Button4 


resized window. position and size change dynamically 
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QGridLayout Class 


A GridLayout class object presents with a grid of cells arranged in rows and columns. The 
class contains addWidget() method. Any widget can be added by specifying the number 
of rows and columns of the cell. Optionally, a spanning factor for row as well as column, 
¡if specified makes the widget wider or taller than one cell. Two overloads of addWidget() 
method are as follows: 


Methods €: Description 


addWidget(QWidget, int r, int c) 


Adds a widget at specified row and column 


addWidget(QWidget, int r, int c, int rowspan, int columnspan) 


Adds a widget at specified row and column and having specified width and/or 


height 


Methods €: Description 
addLayout(QLayout, int r, int c) 


Adds a layout object at specified row and column 


Example 


The following code creates a grid layout of 16 push buttons arranged in a grid layout of 4 
rows and 4 columns. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


def window(): 
app = QApplication(sys.argv) 
win = QWidget() 
grid = QGridLayout() 


for i in range(1,5): 
for j in range(1,5): 
grid.addWidget(QPushButton("B"+str(i)+str(j)),i,j3) 


win.setLayout(grid) 
win.setGeometry(100,100,200,100) 
win.setWindowTitle("PyQt Grid Layout") 
win.show() 
sys.exit(app.exec_()) 

if _ name__ == '  main_': 
window( ) 
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The code uses two nested for loops for row and column numbers, denoted by variables ¡ 
and j. They are converted to string to concatenate the caption of each push button to be 
added at ¡” row and j*” column. 


The above code produces the following output: 


E” PyOQt Grid Layout ll O X 
B11 B12 B13 B14 
B21 B22 B23 B24 
B31 B32 B33 B34 
B41 B42 B43 Do 
QFormLayout Class 


QFormLayout ¡is a convenient way to create two column form, where each row consists 
of an input field associated with a label. As a convention, the left column contains the label 
and the right column contains an input field. There are mainly three overloaded versions 
of addRow() method that are commonly used. 


addRow(QLabel, QWidget) 

Adds a row containing label and input field 
addRow(QLabel, QLayout) 

Adds a child layout in the second column 


addRow(QWidget) 


Adds a widget spanning both columns 


Example 


This code adds a LineEdit field to input name in the first row. Then it adds a vertical box 
layout for two address fields in the second column of the next row. Next, a horizontal box 
layout object containing two Radio button fields is added in the second column of the third 
row. The fourth row shows two buttons 'Submit' and 'Cancel'. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


def window(): 
app = QApplication(sys.argv) 
win = Quidget() 


27 


tutorialspoint 


PyQt 


11 = QLabel("Name") 
nm = QLineEdit() 


12 = QLabel("Address") 
add1 = QLineEdit() 
add2 = QLineEdit() 
fbox = QFormLayout() 
fbox.addRow(11,nm) 
vbox = QVBoxLayout() 


vbox.addWidget(add1) 
vbox.addWidget(add2) 
fbox.addRow(12,vbox) 
hbox = QHBoxLayout() 


r1 = QRadioButton("Male") 

r2 = QRadioButton("Female") 

hbox.addWidget(r1) 

hbox.addWidget(r2) 

hbox.addStretch() 

fbox.addRow(QLabel("sex"),hbox) 
fbox.addRow(QPushButton("Submit"),QPushButton("Cancel")) 


win.setLayout(fbox) 


win.setWindowTitle("PyQt5 Form Layout") 
win.show() 
sys.exit(app.exec_()) 

if  name__ == ' main_': 
window( ) 


The above code produces the following output: 


A” PyQt Form Layout - O X 


Name IS 
Address 
sex O Male Ó) Female 
Submit Cancel 
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8. PyQt5 — Basic Widgets 


Here is the list of Widgets which we will discuss one by one in this chapter. 


Sr.No Widgets 8: Description 


QLabel 

1 A QLabel object acts as a placeholder to display non-editable text or image, or a 
movie of animated GIF. It can also be used as a mnemonic key for other widgets. 
QLineEdit 

2 QLineEdit object is the most commonly used input field. It provides a box in which 
one line of text can be entered. In order to enter multi-line text, QTextEdit object 
is required. 
QPushButton 

3 In PyQt API, the QPushButton class object presents a button which when clicked 
can be programmed to invoke a certain function. 
QRadioButton 

4 A QRadioButton class object presents a selectable button with a text label. The 
user can select one of many options presented on the form. This class is derived 
from QAbstractButton class. 
QCheckBox 

5 A rectangular box before the text label appears when a QCheckBox object is added 
to the parent window. Just as QRadioButton, it is also a selectable button. 
QComboBox 

6 A QComboBox object presents a dropdown list of items to select from. It takes 
minimum screen space on the form required to display only the currently selected 
item. 
QSpinBox 

7 A QSpinBox object presents the user with a textbox which displays an integer with 
up/down button on its right. 
QSlider Widget € Signal 

8 QSlider class object presents the user with a groove over which a handle can be 
moved. It is a classic widget to control a bounded value. 
QMenuBar, QMenu € QAction 

9 


A horizontal QMenuBar just below the title bar of a QMainWindow object is reserved 
for displaying QMenu objects. 
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11 


12 


13 


14 


15 


16 


17 


18 
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QToolBar 


A QToolBar widget is a movable panel consisting of text buttons, buttons with icons 
or other widgets. 


QInputDialog 


This is a preconfigured dialog with a text field and two buttons, OK and Cancel. 
The parent window collects the input in the text box after the user clicks on Ok 
button or presses Enter. 


QFontDialog 


Another commonly used dialog, a font selector widget is the visual appearance of 
QDialog class. Result of this dialog is a Qfont object, which can be consumed by 
the parent window. 


QFileDialog 


This widget is a file selector dialog. It enables the user to navigate through the file 
system and select a file to open or save. The dialog is invoked either through static 
functions or by calling exec_() function on the dialog object. 


QTab 


If a form has too many fields to be displayed simultaneously, they can be arranged 
in different pages placed under each tab of a Tabbed Widget. The QTabWidget 
provides a tab bar and a page area. 


QStacked 


Functioning of QStackedWidget is similar to QTabWidget. It also helps in the 
efficient use of window's client area. 


QSplitter 


This is another advanced layout manager which allows the size of child widgets to 
be changed dynamically by dragging the boundaries between them. The Splitter 
control provides a handle that can be dragged to resize the controls. 


QDock 


A dockable window is a subwindow that can remain in floating state or can be 
attached to the main window at a specified position. Main window object of 
QMainWindow class has an area reserved for dockable windows. 


QStatusBar 


QMainWindow object reserves a horizontal bar at the bottom as the status bar. It 
is used to display either permanent or contextual status information. 


QList 


QListWidget class is an item-based interface to add or remove items from a list. 
Each item in the list is a QListWidgetltem object. ListWidget can be set to be 
multiselectable. 


30 


)tutorialspoint 


PyQt 


QScrollBar 
20 A scrollbar control enables the user to access parts of the document that is outside 


the viewable area. It provides visual indicator to the current position. 


QCalendar 


21 QCalendar widget is a useful date picker control. It provides a month-based view. 
The user can select the date by the use of the mouse or the keyboard, the default 
being today's date. 


QLabel Widget 


A QLabel object acts as a placeholder to display non-editable text or image, or a movie 
of animated GIF. It can also be used as a mnemonic key for other widgets. Plain text, 
hyperlink or rich text can be displayed on the label. 


The following table lists the important methods defined in QLabel class: 
Sr.No. Methods 8: Description 
setAlignment() 
Aligns the text as per alignment constants 
Qt.AlignLeft 
Qt.AlignRight 
Qt.AlignCenter 
Qt.AlignJustify 
setIndent() 
Sets the labels text indent 
setPixmap() 
Displays an image 
Text() 
Displays the caption of the label 
setText() 
Programmatically sets the caption 
selectedText() 


Displays the selected text from the label (The textInteractionFlag must be set to 
TextSelectableByMouse) 


7 setBuddy() 
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Associates the label with any input widget 


setWordWrap() 


Enables or disables wrapping text in the label 


Signals of QLabel Class 


If the label containing embedded hyperlink is clicked, the URL will 


INIRACEVALSS open. setOpenExternalLinks feature must be set to true. 


Slot method associated with this signal will be called when the label having 


INIOverea embedded hyperlink is hovered by the mouse. 


Example 


In this example, QLabel objects |2 and 14 have the caption containing hyperlink. 
setOpenExternalLinks for 12 is set to true. Hence, if this label is clicked, the associated URL 
will open in the browser. linkHovered signal of l4 is connected to hovered() function. So, 
whenever the mouse hovers over it, the function will be executed. 


QPixmap object prepares offscreen image from python.jpg file. It is displayed as label 13 
by using setPixmap() method. 


import sys 
from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 
def window(): 
app = QApplication(sys.argv) 
win = QuWidget() 


11 = QLabel() 
12 = QLabel() 
13 = QLabel() 
14 = QLabel() 


11.setText("Hello World") 
14.setText("TutorialsPoint") 


12.setText("welcome to Python GUI Programming”) 


11.setAlignment(Qt.AlignCenter) 
13.setAlignment(Qt.AlignCenter) 
14.setAlignment(Qt.AlignRight) 
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13.setPixmap(QPixmap("python.png")) 


vbox 


vbox. 
vbox. 
vbox. 


vbox. 


vbox 


vbox. 


vbox 


= QVBoxLayout() 
addWidget(11) 
addStretch() 
addWidget(12) 
addStretch() 


.addWidget(13) 


addStretch() 


.addWidget(14) 


14.setOpenExternalLinks(True) 


14.linkActivated.connect(clicked) 


12.1inkHovered.connect(hovered) 


11.setTextInteractionFlags(Qt.TextSelectableByMouse) 


win.setLayout(vbox) 


win.setWindowTitle("QLabel Demo") 


win.show() 


sys.exit(app.exec_()) 


def hovered(): 


print ("hovering") 
def clicked(): 
print ("clicked”) 


if  name__ == 


_ Mmain_': 


window( ) 


The above code produces the following output: 
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E OLabel Demo = O Xx 


TutorialsPoint 
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QLineEdit Widget 


QLineEdit object is the most commonly used input field. It provides a box in which one 
line of text can be entered. In order to enter multi-line text, QTextEdit object is required. 


The following table lists a few important methods of QLineEdit class: 


Sr.No. Methods 8: Description 


setAlignment() 

Aligns the text as per alignment constants 
Qt.AlignLeft 

Qt.AlignRight 

Qt.AlignCenter 

Qt.AlignJustify 

clear() 

Erases the contents 

setEchoMode() 

Controls the appearance of the text inside the box. Echomode values are — 
QLineEdit.Normal 

QLineEdit.NoEcho 

QLineEdit.Password 
QLineEdit.PasswordEchoOnEdit 
setMaxLength() 

Sets the maximum number of characters for input 
setReadOnly() 

Makes the text box non-editable 

setText() 

Programmatically sets the text 

text() 

Retrieves text in the field 

setValidator() 

Sets the validation rules. Available validators are 
QIntValidator — Restricts input to integer 


QDoubleValidator — Fraction part of number limited to specified decimals 
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QRegexpValidator — Checks input against a Regex expression 
setInputMask() 
Applies mask of combination of characters for input 


setFont() 


Displays the contents QFont object 


QLineEdit object emits the following signals: 


Given below are the most commonly used methods of signals. 


Sr.No. Methods €: Description 


¡ Whenever the cursor moves 
editingFinished() 

? When you press 'Enter' or the field loses focus 
returnPressed() 

j When you press 'Enter' 
selectionChanged() 

Ñ Whenever the selected text changes 
textChanged() 

> As text in the box changes either by input or by programmatic means 
textEdited() 

d Whenever the text is edited 

Example 


QLineEdit objects in this example demonstrate use of some of these methods. 


cursorPositionChanged() 


PyQt 


First field el shows text using a custom font, in right alignment and allows integer input. 
Second field restricts input to a number with 2 digits after decimal point. An input mask 
for entering the phone number is applied on the third field. textChanged() signal on the 
field e4 is connected to textchanged() slot method. 


Contents of eb field are echoed in password form as its EchoMode property is set to 
Password. Its editingfinished() signal is connected to presenter() method. So, once the 
user presses the Enter key, the function will be executed. The field e6 shows a default 
text, which cannot be edited as it is set to read only. 


import sys 


from PyQt5.QtCore import * 


from PyQt5.QtGui import * 
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from PyQt5.QthWidgets import * 


def window(): 
app = QApplication(sys.argv) 
win = QuWidget() 


el = QLineEdit() 
el.setValidator(QIntValidator()) 
el.setMaxLength(4) 
el.setAlignment(Qt.AlignRight) 
el.setFont(QFont("Arial",20)) 


e2 = QLineEdit() 
e2.setValidator(QDoubleValidator(0.99,99.99,2)) 


flo = QFormLayout() 
flo.addRow("integer validator", el) 
flo.addRow("Double validator",e2) 


e3 = QLineEdit() 
e3.setInputMask('+99 9999 999999')> 
flo.addRow( "Input Mask",e3) 


e4 = QLineEdit() 
e4.textChanged.connect(textchanged) 
flo.addRow("Text changed" ,e4) 


e5 = QLineEdit() 
e5.setEchoMode(QLineEdit.Password) 
flo.addRow("Password",e5) 


e6 = QLineEdit("Hello Python") 
e6.setReadOnly(True) 
flo.addRow("Read Only",e6) 


e5.editingFinished.connect(enterPress) 


win.setLayout(flo) 
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win.setWindowTitle("PyQt") 


win.show() 


sys.exit(app.exec_()) 


def textchanged(text): 
print ("contents of text box: ()".format(text)) 


def enterPress(): 


print ("editeing finished") 


if _name__ == ' main_': 


window( ) 


The above code produces the following output: 


A ' PyQt - O X 


integer validator 1 2 3 


Double validator |1234.56 


Input Mask +91_2462_253465 


Text changed ¡hello 


Password [eee] 


Read Only Hello Python 


contents of text box: h 
contents of text box: he 
contents of text box: hel 
contents of text box: hell 
contents of text box: hello 


editing finished 


38 


N tutorialspoint 


SIMPLYEASYLEARNING 


PyQt 


QPushButton Widget 


In any GUI design, the command button is the most important and most often used 
control. Buttons with Save, Open, OK, Yes, No and Cancel, etc., as caption are familiar to 
any computer user. In PyQt API, the QPushButton class object presents a button which 
when clicked can be programmed to invoke a certain function. 


QPushButton class inherits its core functionality from QAbstractButton class. It is 
rectangular in shape and a text caption or icon can be displayed on its face. 


Following are some of the most commonly used methods of QPushButton class: 


Sr.No. Methods 8: Description 


setCheckable() 
: Recognizes pressed and released states of button if set to true 
toggle() 
? Toggles between checkable states 
setIcon() 
j Shows an icon formed out of pixmap of an image file 
setEnabled() 
Ñ When set to false, the button becomes disabled, hence clicking it doesn't emit a 
signal 
isChecked() 
j Returns Boolean state of button 
setDefault() 
' Sets the button as default 
setText() 
/ Programmatically sets buttons” caption 
text() 
8 
Retrieves buttons” caption 
Example 


Four QPushButton objects are set with some of the above attributes. The example is 
written in object oriented form, because the source of the event is needed to be passed 
as an argument to slot function. 


Four QPushButton objects are defined as instance variables in the class. First button b1 is 
converted into toggle button by the statements: 


self.b1.setCheckable(True) 
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self.b1.toggle() 


Clicked signal of this button is connected to a member method btnstate() which identifies 
whether button is pressed or released by checking isChecked() property. 


def btnstate(self): 
if self.b1.isChecked(): 
print "button pressed" 
else: 


print "button released" 


Second button b2 displays an icon on the face. setlcon() method takes a pixmap object 
of any image file as argument. 


b2.setIcon(QIcon(QPixmap("python.gif"))) 


Button b3 ¡is set to be disabled by using setEnabled() method: 


b3.setEnabled(False) 


PushButton b4 ¡s set to default button by setDefault() method. Shortcut to its caption is 
created by prefixing € to the caption (8iDefault). As a result, by using the keyboard 
combination Alt+D, connected slot method will be called. 


Buttons b1 and b4 are connected to whichbtn() slot method. Since the function is intended 
to retrieve caption of the clicked button, the button object should be passed as an 
argument. This is achieved by the use of lambda function. 


Following is the example of the above statement: 


b4.clicked.connect(lambda:self.whichbtn(self.b4)) 


The complete code is given below: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class Form(QDialog): 
def _ init (self, parent=None): 


super(Form, self). init (parent) 


layout = QVBoxLayout() 
self.b1 = QPushButton("Button1”) 
self.b1.setCheckable(True) 
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self.b1.toggle() 
self.b1.clicked.connect(lambda:self.whichbtn(self.b1)) 
self.b1.clicked.connect(self.btnstate) 

layout .addWidget(self.b1) 


self.b2 = QPushButton() 
self.b2.setIcon(QIcon(QPixmap("pythonlogo.png")>))) 
self.b2.clicked.connect(lambda:self.whichbtn(self.b2)) 
layout .addWidget(self.b2) 

self.setLayout(layout) 

self.b3 = QPushButton("Disabled”) 
self.b3.setEnabled(False) 

layout .addWidget(self.b3) 


self.b4 = QPushButton("8Default") 
self.b4.setDefault(True) 
self.b4.clicked.connect(lambda:self.whichbtn(self.b4)) 
layout .addWidget(self.b4) 


self.setWindowTitle("Button demo”) 


def btnstate(self): 
if self.b1.isChecked(): 
print ("button pressed") 
else: 


print ("button released") 


def whichbtn(self,b): 
print ("clicked button is "+b.text()) 


def main(): 


app = QApplication(sys.argv) 
ex = Form() 
ex.show() 


sys.exit(app.exec_()) 
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main() 


The above code produces the following output. 


ñ' Button demo ? X 


Button1 


+ 


Disabled 


Default 


clicked button is Button1 
button released 

clicked button is Button1 
button pressed 


clicked button is 8Default 
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QRadioButton Widget 


A QRadioButton class object presents a selectable button with a text label. The user can 
select one of many options presented on the form. This class is derived from 
QAbstractButton class. 


Radio buttons are autoexclusive by default. Hence, only one of the radio buttons in the 
parent window can be selected at a time. If one is selected, previously selected button is 


automatically deselected. Radio buttons can also be put in 
a QGroupBox or QButtonGroup to create more than one selectable fields on the parent 
window. 


The following listed methods of QRadioButton class are most commonly used. 


Sr.No. Methods €: Description 
setChecked() 

i Changes the state of radio button 
setText() 

¡ Sets the label associated with the button 
text() 

3 
Retrieves the caption of button 

a isChecked() 


Checks if the button is selected 
Default signal associated with QRadioButton object is toggled(), although other signals 


inherited from QAbstractButton class can also be implemented. 


Example 


Here two mutually exclusive radio buttons are constructed on a top level window. 


Default state of b1 is set to checked by the statement: 


Self.b1.setChecked(True) 


The toggled() signal of both the buttons is connected to btnstate() function. Use of lambda 
allows the source of signal to be passed to the function as an argument. 


self.b1.toggled.connect(lambda:self.btnstate(self.b1)) 
self.b2.toggled.connect(lambda:self.btnstate(self.b2)) 


The btnstate() function checks state of button emitting toggled() signal. 


if b.isChecked() == True: 
print b.text()+" is selected" 


else: 
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print b.text()+" is deselected” 


Complete code for QRadioButton example is as below: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 


class Radiodemo(QWidget): 


def _ init (self, parent = None): 


super(Radiodemo, self). init _ (parent) 


layout = QHBoxLayout() 

self.b1 = QRadioButton("Button1”) 
self.b1.setChecked(True) 
self.b1.toggled.connect(lambda:self.btnstate(self.b1)) 
layout .addWidget(self.b1) 


self.b2 = QRadioButton("Button2"”) 
self.b2.toggled.connect(lambda:self.btnstate(self.b2)) 


layout .addWidget(self.b2) 
self.setLayout(layout) 
self.setWindowTitle("RadioButton demo") 


def btnstate(self,b): 


if b.text() == "Button1": 
if b.isChecked() == True: 
print (b.text()+" is selected”) 
else: 


print (b.text()+" is deselected”) 


if b.text() == "Button2": 
if b.isChecked() == True: 
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print (b.text()+" is selected”) 
else: 


print (b.text()+" is deselected”) 
def main(): 
app = QApplication(sys.argv) 
ex = Radiodemo() 
ex.show() 


sys.exit(app.exec_()) 


if  name__ == '  main_': 


The above code produces the following output: 


A” RadioButton demo =S 


(8) Button1 O Button2 


Button1 is deselected 
Button2 is selected 
Button2 is deselected 


Button1 is selected 
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QCheckBox Widget 


A rectangular box before the text label appears when a QCheckBox object is added to 
the parent window. Just as QRadioButton, it is also a selectable button. Its common use 
is in a scenario when the user is asked to choose one or more of the available options. 


Unlike Radio buttons, check boxes are not mutually exclusive by default. In order to restrict 
the choice to one of the available items, the check boxes must be added to QButtonGroup. 


The following table lists commonly used QCheckBox class methods: 


Sr.No. Methods €: Description 


setChecked() 

: Changes the state of checkbox button 
setText() 

] Sets the label associated with the button 
text() 

3 
Retrieves the caption of the button 
isChecked() 

ú Checks if the button ¡is selected 

E setTriState() 


Provides no change state to checkbox 


Each time a  checkbox  ¡s either checked or  cleared, the object 
emits stateChanged() signal. 


Example 


Here, two QCheckBox objects are added to a horizontal layout. Their stateChanged() signal 
is connected to btnstate() function. The source object of signal is passed to the function 
using lambda. 


self.b1.stateChanged.connect(lambda:self.btnstate(self.b1)) 
self.b2.toggled.connect(lambda:self.btnstate(self.b2)) 


The isChecked() function is used to check if the button is checked or not. 


if b.text() == "Button1": 
if b.isChecked() == True: 
print b.text()+" is selected" 
else: 


print b.text()+" is deselected” 


The complete code is as follows: 
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import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class checkdemo(QWidget): 
def _ init (self, parent = None): 


super(checkdemo, self). init _ (parent) 


layout = QHBoxLayout () 

self.b1 = QCheckBox("Button1") 

self.b1.setChecked(True) 
self.b1.stateChanged.connect(lambda:self.btnstate(self.b1)) 
layout .addWidget(self.b1) 


self.b2 = QCheckBox("Button2") 
self.b2.toggled.connect(lambda:self.btnstate(self.b2)) 


layout .addWidget(self.b2) 
self.setLayout(layout) 
self.setWindowTitle("checkbox demo”) 


def btnstate(self,b): 
if b.text() == "Button1": 
if b.isChecked() == True: 
print (b.text()+" is selected”) 
else: 


print (b.text()+" is deselected”) 
if b.text() == "Button2": 
if b.isChecked() == True: 


print (b.text()+" is selected”) 


else: 


print (b.text()+" is deselected”) 


def main(): 
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app = QApplication(sys.argv) 
ex = checkdemo() 
ex.show() 


sys.exit(app.exec_()) 


if  name__ == ' main_': 


The above code produces the following output: 
ñ ' checkbox demo = O X 


Button1 [] Button2 


Button2 is selected 
Button2 is deselected 
Button1 is deselected 


Button1 is selected 


As mentioned earlier, checkBox buttons can be made mutually exclusive by adding them 


in the QButtonGroup object. 


self.bg = QButtonGroup() 
self.bg.addButton(self.b1,1) 
self.bg.addButton(self.b2,2) 


QButtonGroup object, provides abstract container for buttons and doesn't have a visual 
representation. It emits buttonCliked() signal and sends Button object's reference to the 


slot function btngroup(). 


self.bg.buttonClicked[QAbstractButton].connect(self.btngroup) 


The btngroup() function displays the caption of the clicked checkbox. 


def btngroup(self,btn): 
print (btn.text()+" is selected”) 


After above changes, the application window appears as follows: 
A" checkbox demo — O Xx 


[] Buttoni Button2 
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Button1 is selected 
Button2 is selected 


Button1 is selected 


QComboBox Widget 


A QComboBox object presents a dropdown list of items to select from. It takes minimum 
screen space on the form required to display only the currently selected ¡tem. 


A Combo box can be set to be editable; it can also store pixmap objects. The following 
methods are commonly used: 


Sr.No. Methods €: Description 


addlItem() 

¡ Adds string to collection 
addltems() 

j Adds items in a list object 
Clear() 

3 
Deletes all items in the collection 
count() 

4 
Retrieves number of items in the collection 
currentText() 

j Retrieves the text of currently selected item 
itemText() 

¡ Displays text belonging to specific index 
currentindex() 

/ Returns index of selected ¡tem 

E setltemText() 


Changes text of specified index 


QComboBox Signals 


The following methods are commonly used in QComboBox Signals: 
Sr.No. Methods 8 Description 


activated() 


When the user chooses an item 
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currentindexChanged() 


2 
Whenever the current index is changed either by the user or programmatically 
highlighted() 
3 
When an item in the list is highlighted 
Example 


Let us see how some features of QComboBox widget are implemented in the following 
example. 


Items are added in the collection individually by addltem() method or items in a List object 
by addItems() method. 


self.cb.addItem("C++") 
self.cb.addItems(["Java", "C*", "Python"]) 


QComboBox object emits  currentindexChanged() signal. It ¡is connected 
to selectionchange() method. 


Items in a combo box are listed using itemText() method for each item. Label belonging 
to the currently chosen item is accessed by currentText() method. 


def selectionchange(self,i): 


print ("Items in the list are :") 


for count in range(self.cb.count()): 


print (self.cb.itemText(count)) 


print ("Current index",i,"selection changed ",self.cb.currentText()) 


The entire code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class combodemo(QWidget): 
def _ init (self, parent = None): 


super(combodemo, self). init _ (parent) 


layout = QHBoxLayout () 
self.cb = QComboBox() 


self.cb.addItem("C") 
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self.cb.addItem("C++") 
self.cb.addItems([ "Java", "CH", 


"Python"]) 


self.cb.currentIndexChanged.connect(self.selectionchange) 


layout .addWidget(self.cb) 
self.setLayout(layout) 


self.setWindowTitle("combo box demo") 


def selectionchange(self,i): 


print ("Items in the list are 


5) 


for count in range(self.cb.count()): 


print (self.cb.itemText(count)) 


print ("Current index",i,"selection 


def main(): 
app = QApplication(sys.argv) 


ex = combodemo( ) 
ex.show() 


sys.exit(app.exec_()) 


changed ",self.cb.currentText()) 


The above code produces the following output: 


combo box demo 


Items in the list are as follows: 
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CH+ 
Python 


Current selection index 4 selection changed Python 


QSpinBox Widget 


A QSpinBox object presents the user with a textbox which displays an integer with 
up/down button on its right. The value in the textbox increases/decreases if the up/down 
button is pressed. 


By default, the integer number in the box starts with O, goes upto 99 and changes by step 
1. You can use QDoubleSpinBox for float values. 


Important methods of QSpinBox class are listed in the following table: 


Sr.No. Methods €: Description 
setMinimum() 

i Sets the lower bound of counter 
setMaximum() 

; Sets the upper bound of counter 
setRange() 

j Sets the minimum, maximum and step value 
setValue() 

il Sets the value of spin box programmatically 
Value() 

j Returns the current value 

A singleStep() 


Sets the step value of counter 


QSpinBox object emits valueChanged() signal every time when up/own button is 
pressed. The associated slot function can retrieve current value of the widget 
by value() method. 


Following example has a label (11) and spinbox (sp) put in vertical layout of a top window. 
The valueChanged() signal is connected to valuechange() method. 
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self.sp.valueChanged.connect(self.valuechange) 


The valueChange() function displays the current value as caption of the label. 


self.11.setText("current value: "+str(self.sp.value())) 


The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class spindemo(QWidget): 
def _ init (self, parent = None): 


super(spindemo, self). init _ (parent) 


layout = QVBoxLayout() 

self.11 = QLabel("current value:") 
self.11.setAlignment(Qt.AlignCenter) 
layout .addWidget(self.11) 


self.sp = QSpinBox() 


layout .addWidget(self.sp) 
self.sp.valueChanged.connect(self.valuechange) 
self.setLayout(layout) 
self.setWindowTitle("SpinBox demo”) 


def valuechange(self): 


self.11.setText("current value: "+str(self.sp.value())) 


def main(): 
app = QApplication(sys.argv) 
ex = spindemo() 
ex.show() 


sys.exit(app.exec_()) 
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The above code produces the following output: 


ñ” SpinBox demo — O X 


current value: 10 


4» 


QSlider Widget 


QSlider class object presents the user with a groove over which a handle can be moved. 
It is a classic widget to control a bounded value. Position of the handle on the groove is 
equivalent to an integer between the lower and the upper bounds of the control. 


A slider control can be displayed in horizontal or vertical manner by mentioning the 
orientation in the constructor. 


self.sp = QSlider(Qt.Horizontal) 
self.sp = QSlider(Qt.Vertical) 


The following table lists some of the frequently used methods of QSlider class: 


Sr.No. Methods €: Description 


setMinimum() 

i Sets the lower bound of the slider 
setMaximum() 

? Sets the upper bound of the slider 
setSingleStep() 

] Sets the increment/decrement step 
setValue() 

i Sets the value of the control programmatically 
value() 

5 
Returns the current value 
setTickInterval() 

j Puts the number of ticks on the groove 
setTickPosition() 
Places the ticks on the groove. Values are — 

7 


QSlider.NoTicks No tick marks 


QSlider.TicksBothSides Tick marks on both sides 
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QSlider.TicksAbove Tick marks above the slider 
QSlider.TicksBelow Tick marks below the slider 
QSlider.TicksLeft Tick marks to the left of the slider 


QSlider.TicksRight Tick marks to the right of the slider 


QSlider Signals 


The following are the methods in QSlider Signals: 


Sr.No. Methods €: Description 


valueChanged() 

¡ When the slider's value has changed 
sliderPressed() 

a When the user starts to drag the slider 
sliderMoved() 

> When the user drags the slider 

' sliderReleased() 


When the user releases the slider 


valueChanged() signal is the one which is most frequently used. 


Example 


The following example demonstrates the above functionality. A Label and a horizontal 
slider is placed in a vertical layout. Slider's valueChanged() signal is connected to 
valuechange() method. 


self.sl.valueChanged.connect(self.valuechange) 


The slot function valuechange() reads current value of the slider and uses it as the size of 
font for label's caption. 


size = self.sl.value() 


self.11.setFont(QFont("Arial",size)) 


The complete code is as follows: 


import sys 
from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
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from PyQt5.QthWidgets import * 


class sliderdemo(QNidget): 
def _ init (self, parent = None): 
super(sliderdemo, self).  init_ (parent) 
layout = QVBoxLayout() 
self.11 = QLabel("Hello") 
self.11.setAlignment(Qt.AlignCenter) 
layout .addWidget(self.11) 


self.s1l = QSlider(Qt.Horizontal) 
self.s1l.setMinimum(10) 
self.sl.setMaximum(30) 

self.sl.setValue(20) 
self.sl.setTickPosition(QSlider.TicksBelow) 
self.sl.setTickInterval(5) 


layout .addWidget(self.s1l) 
self.sl.valueChanged.connect(self.valuechange) 
self.setLayout(layout) 
self.setWindowTitle("Slider Demo”) 


def valuechange(self): 
size = self.sl.value() 


self.11.setFont(QFont("Arial",size)) 


def main(): 
app = QApplication(sys.argv) 
ex = sliderdemo() 
ex.show() 


sys.exit(app.exec_()) 


The above code produces the following output — 
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A" Slider Demo — O X 


Hello 
y 


The font size of the label changes as handle of the slider is moved across the handle. 


QMenuBar, QMenu 8. QAction Widgets 


A horizontal QMenuBar just below the title bar of a QMainWindow object is reserved for 
displaying QMenu objects. 


QMenu class provides a widget which can be added to menu bar. It is also used to create 
context menu and popup menu. Each QMenu object may contain one or 
more QAction objects or cascaded QMenu objects. 


To create a popup menu, PyQt API provides createPopupMenu() function. menuBar() 
function returns main window's QMenuBar object. addMenu() function lets addition of 
menu to the bar. In turn, actions are added in the menu by addAction() method. 


Following table lists some of the important methods used in designing a menu system. 


Sr.No. Methods €: Description 


menuBar() 

: Returns main window's QMenuBar object 
addMenu() 

: Adds a new QMenu object to menu bar 
addAction() 

i Adds an action button to QMenu widget consisting of text or icon 
setEnabled() 

Ñ Sets state of action button to enabled/disabled 
addSeperator() 

i Adds a separator line in the menu 
Clear() 

6 
Removes contents of menu/menu bar 
setShortcut() 

d Associates keyboard shortcut to action button 

8 setText() 


57 


)tutorialspoint 


PyQt 


Assigns text to action button 


setTitle() 
9 
Sets the title of QMenu widget 
text() 
10 
Retrieves the text associated with QAction object 
title() 
11 


Retrieves the text associated with QMenu object 


QMenu object emits triggered() signal whenever any QAction button is clicked. Reference 
to the clicked QAction object is passed on to the connected slot function. 


Example 


In this example, first all reference to QMenuBar object of top level window (which has to 
be a QMainWindow object) is stored. 


bar = self.menuBar() 


File menu is added to the menu bar by addMenu() method. 


file = bar.addMenu("File") 


An action button in the menu may be a string or a QAction object. 


file.addAction("New") 
save = QAction("Save",self) 
save.setshortcut("Ctrl+S") 
file.addAction(save) 


A submenu is added to top level menu. 


edit = file.addMenu("Edit") 
edit.addAction("copy”) 
edit.addAction("paste") 


triggered() signal emitted by file menu is connected to processtrigger() method, which 
receives QAction object causing the signal. 


file.triggered[QAction].connect(self.processtrigger) 


The complete code is as follows: 


import sys 


from PyQt5.QtCore import * 
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from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class menudemo(QMainWindow) : 
def _ init (self, parent = None): 


super(menudemo, self). _ init_ (parent) 


layout = QHBoxLayout () 

bar = self.menuBar() 

file = bar.addMenu("File") 
file.addAction("New") 


save = QAction("Save",self) 
save.setShortcut("Ctrl+S"”) 


file.addAction(save) 


edit = file.addMenu("Edit") 
edit.addAction("copy”) 
edit.addAction("paste") 


quit = QAction("Quit",self) 

file.addAction(quit) 
file.triggered[QAction].connect(self.processtrigger) 
self.setLayout(layout) 


self.setWindowTitle("Menu Demo”) 


def processtrigger(self,q): 
print (q.text()+" is triggered”) 


def main(): 
app = QApplication(sys.argv) 
ex = menudemo() 
ex.show() 


sys.exit(app.exec_()) 
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main() 


The above code produces the following output: 


| E Menu Demo — O Xx 


| File 
New | 
| Save Ctrl+S 
| Quit paste 


QToolBar Widget 


A QToolIBar widget is a movable panel consisting of text buttons, buttons with icons or 
other widgets. 


It is usually situated in a horizontal bar below menu bar, although it can be floating. Some 
useful methods of QToolBar class are as follows: 


Sr.No. Methods €: Description 


addAction() 

: Adds tool buttons having text or icon 
addSeperator() 

j Shows tool buttons in groups 
addWidget() 

? Adds controls other than button in the toolbar 
addToolBar() 

il QMainWindow class method adds a new toolbar 
setMovable() 

d Toolbar becomes movable 

E setOrientation() 


Toolbar's orientation sets to Qt.Horizontal or Qt.vertical 


Whenever a button on the toolbar is clicked, ActionTriggered() signal is emitted. 
Additionally, it sends reference to QAction object associated with the event to the 
connected function. 


A File toolbar is added in the toolbar area by calling addToolBar() method. 
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tb = self.addToolBar("File") 


Although tool buttons with text captions can be added, a toolbar usually contains graphic 
buttons. A QAction object with an icon and name is added to the toolbar. 


new = QAction(QIcon("new.bmp"),"new",self) 


tb.addAction(new) 


Similarly, open and save buttons are added. 


Finally, actionTriggered() signal is connected to a slot function toolbtnpressed(). 


tb.actionTriggered[QAction].connect(self.toolbtnpressed) 


The complete code to execute the example is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class tooldemo(QMainWindow) : 
def _ init (self, parent = None): 
super(tooldemo, self). init _ (parent) 
layout = QVBoxLayout() 
tb = self.addToolBar("File") 


new = QAction(QIcon("new.png"),"new",self) 


tb.addAction(new) 


open = QAction(QIcon("open.png"),"open",self) 
tb.addAction(open) 

save = QAction(QIcon("save.png"),"save",self) 
tb.addAction(save) 
tb.actionTriggered[QAction].connect(self.toolbtnpressed) 
self.setLayout(layout) 

self.setWindowTitle("toolbar demo”) 


def toolbtnpressed(self,a): 
print ("pressed tool button is",a.text()) 
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def main(): 
app = QApplication(sys.argv) 
ex = tooldemo() 
ex.show() 


sys.exit(app.exec_()) 


The above code produces the following output: 
E * toolbar demo sa O X 
open 


QlinputDialog Widget 


This is a preconfigured dialog with a text field and two buttons, OK and Cancel. The parent 
window collects the input in the text box after the user clicks on Ok button or presses 
Enter. 


The user input can be a number, a string or an item from the list. A label prompting the 
user what he should do is also displayed. 


The QInputDialog class has the following static methods to accept input from the user: 


Sr.No. Methods €: Description 


getInt() 

i Creates a spinner box for integer number 
getDouble() 

] Spinner box with floating point number can be input 
getText() 

j A simple line edit field to type text 
getltem() 

4 


A combo box from which user can choose ¡item 
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Example 


The following example implements the input dialog functionality. The top level window has 
three buttons. Their clicked() signal pops up InputDialog through connected slots. 


items = ("C", "C++", "Java", "Python") 


item, ok = QInputDialog.getItem(self, "select input dialog", 


"list of languages", items, 0, False) 


if ok and item: 


self.le.setText(item) 


def gettext(self): 


text, ok = QInputDialog.getText(self, 'Text Input Dialog', 'Enter your 
name: '>) 


if ok: 
self.lel.setText(str(text)) 


def getint(self): 


num,ok = QInputDialog.getInt(self,"integer input dualog","enter a 
number") 


if ok: 
self.1le2.setText(str(num)) 


The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class inputdialogdemo(QWidget): 
def _ init (self, parent = None): 


super(inputdialogdemo, self). _ init_ (parent) 


layout = QFormLayout() 
self.btn = QPushButton("Choose from list") 
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self.btn.clicked.connect(self.getlItem) 


self.le = QLineEdit() 

layout .addRow(self.btn,self.le) 
self.btn1 = QPushButton("get name") 
self.btn1.clicked.connect(self.gettext) 


self.lel = QLineEdit() 

layout .addRow(self.btn1,self.lel) 

self.btn2 = QPushButton("Enter an integer") 
self.btn2.clicked.connect(self.getint) 


self.le2 = QLineEdit() 

layout .addRow(self.btn2,self.1le2) 
self.setLayout(layout) 
self.setWindowTitle("Input Dialog demo") 


def getItem(self): 


items = ("C", "C++", "Java", "Python”) 


item, ok = QInputDialog.getlItem(self, "select input dialog", 


"list of languages", items, 0, False) 


if ok and item: 


self.le.setText(item) 


def gettext(self): 


text, ok = QInputDialog.getText(self, 'Text Input Dialog', 'Enter your 
name: ') 


if ok: 
self.lel.setText(str(text)) 


def getint(self): 


num,ok = QInputDialog.getInt(self,"integer input dialog","enter a 
number") 
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if ok: 
self.1le2.setText(str(num)) 


def main(): 
app = QApplication(sys.argv) 
ex = inputdialogdemo() 
ex.show() 


sys.exit(app.exec_()) 


if  name__ == ' main_': 


The above code produces the following output: 


E" Input Dialog demo ES O X 


Choose from list 


get name 


Enter an integer 


A | select input dialog ? X A * Text Input Dialog ? Xx A. integer input dialog ? Xx 


list oflanguages Enter your name: enter a number 


Cc Y TutorialsPoint 10] + 


E. Input Dialog demo == O X 


Choose from list [C++ 


get name TutorialsPoint 


Enter an integer [10 


QFontDialog Widget 


Another commonly used dialog, a font selector widget is the visual appearance 
of QDialog class. Result of this dialog is a QFont object, which can be consumed by the 
parent window. 


The class contains a static method getFont(). It displays the font selector 
dialog. setCurrentFont() method sets the default Font of the dialog. 


Example 
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The following example has a button and a label. When the button is clicked, the font dialog 
pops up. The font chosen by the user (face, style and size) is applied to the text on the 
label. 


The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class fontdialogdemo(QWidget): 
def _ init (self, parent = None): 


super(fontdialogdemo, self). init_ (parent) 


layout = QVBoxLayout() 
self.btn = QPushButton("choose font") 
self.btn.clicked.connect(self.getfont) 


layout .addWidget(self.btn) 
self.le = QLabel("Hello") 


layout .addWidget(self.1le) 
self.setLayout(layout) 


self.setWindowTitle("Font Dialog demo") 


def getfont(self): 
font, ok = QFontDialog.getFont() 


if ok: 
self.le.setFont(font) 


def main(): 
app = QApplication(sys.argv) 
ex = fontdialogdemo() 
ex.show() 


sys.exit(app.exec_()) 
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main() 


The above code produces the following output: 


| 2 | Font Dialog demo - O E 1 Select Font Xx 
AAA | 
Terminal 
Hello 


Times New Roman 


Trebuchet MS 


Bold Italic 
Italic 


2 Font Dialog demo 


AaBbYyZz 


[ox]! cae 
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QOFileDialog Widget 


This widget is a file selector dialog. It enables the user to navigate through the file system 
and select a file to open or save. The dialog is invoked either through static functions or 
by calling exec_() function on the dialog object. 


Static functions of QFileDialog class (getOpenFileName() and getSaveFileName()) 
call the native file dialog of the current operating system. 


A file filter can also applied to display only files of the specified extensions. The starting 
directory and default file name can also be set. 


Important methods and enumerations of QFileDialog class are listed in the following table: 
Sr.No. Methods €: Description 


getOpenFileName() 


Returns name of the file selected by the user to open it 


getSaveFileName() 


Uses the file name selected by the user to save the file 


setacceptMode() 

Determines whether the file box acts as open or save dialog 
QFileDialog.AcceptOpen 

QFileDialog.AcceptSave 


setFileMode() 

Type of selectable files. Enumerated constants are — 
QFileDialog.AnyFile 

QFileDialog.ExistingFile 

QFileDialog.Directory 

QFileDialog.ExistingFiles 

setFilter() 


Displays only those files having mentioned extensions 


Example 


Both methods of invoking the file dialog are demonstrated in the following example. 


The first button invokes the file dialog by the static method. 


fname = QFileDialog.getOpenFileName(self, 'Open file', 
'"CiAX', "Image files (*.jpg *.gif)") 
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The selected image file is displayed on a label widget. The second button invokes the file 


dialog by calling exec_() method on QFileDialog object. 


dlg = QFileDialog() 
dlg.setFileMode(QFileDialog.AnyFile) 
dlg.setFilter("Text files (*.txt)") 
filenames = QStringList() 


if dlg.exec_(): 
filenames = dlg.selectedFiles() 


The contents of the selected file are displayed in the TextEdit widget. 


f = open(filenames[0], 'r') 
with f: 
data = f.read() 
self.contents.setText(data) 


The complete code for static method is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class filedialogdemo(QNidget): 
def _ init (self, parent = None): 


super(filedialogdemo, self). init_ (parent) 
layout = QVBoxLayout() 
self.btn = QPushButton("QFileDialog static method demo") 


self.btn.clicked.connect(self.getfile) 


layout .addWidget(self.btn) 
self.le = QLabel("") 


layout .addWidget(self.1le) 


self.setLayout(layout) 
self.setWindowTitle("File Dialog demo") 
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def getfile(self): 
fname = QFileDialog.getOpenFileName(self, 
'd: MX ', "Image files (*.jpg *.png)") 
self.le.setPixmap(QPixmap(fname[0])) 


def main(): 
app = QApplication(sys.argv) 
ex = filedialogdemo() 
ex.show() 
sys.exit(app.exec_()) 
if  name__ == ' main_': 


main() 


'Open file', 


The above code produces the following output: 


A” File Dialog demo - 


O X 


OFileDialog static method demo 
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E * Open file X 


.. Y Ae |< Windows 10 (C:) > QtEnv AY) Search QtEnv Pp 


veto s- 10 


H Downloads +” o A sa 


Documents + 
o pyqt open.png python.png pythonlogo.png 


(== Pictures Al | 
«== Local Disk (D:) | 
 pyqtó 


y QtEnv 


dh» OneDrive y E ¡ Er | =$ Es > 
File name: | pythonlogo.png v | | Imagefiles (*.jpg *.png) Y 


E File Dialog demo e O X 


The complete code for exec_() method is as follows: 


import sys 

from PyQt5.QtCore import * 

from PyQt5.QtGui import * 

from PyQt5.Qthidgets import * 
class CustomDialog(QFileDialog): 
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def 


_ init_ (self, *args, **kwargs): 


super(CustomDialog, self)._ init_ (*args, **kwargs) 
self.setWindowTitle("HELLO!”) 

QBtn = QDialogButtonBox.Ok | QDialogButtonBox.Cancel 
self .buttonBox = QDialogButtonBox(QBtn) 

self .buttonBox.accepted.connect(self.accept) 

self .buttonBox.rejected.connect(self.reject) 
self.layout = QVBoxLayout() 


self.layout.addWidget(self.buttonBox) 
self.setLayout(self.layout) 


class filedialogdemo(QWidget): 


def 


def 


_ init_ (self, parent = None): 


super(filedialogdemo, self). init_ (parent) 


layout = QVBoxLayout() 


self.btn1 = QPushButton("QFileDialog object") 
self.btn1.clicked.connect(self.getfiles) 
layout.addWidget(self.btn1) 


self.contents = QTextEdit() 

layout .addWidget(self.contents) 
self.setlayout(layout) 
self.setWindowTitle("File Dialog demo") 


getfiles(self, s): 
print("click", s) 

dlg = CustomDialog(self) 
if dlg.exec_(): 
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filenames = dlg.selectedFiles() 


f = open(filenames[0], 'r') 


with f: 
data = f.read() 
self.contents.setText(data) 


def main(): 


app = QApplication(sys.argv) 
ex = filedialogdemo() 
ex.show() 


sys.exit(app.exec_()) 


if  name__ == ' main_': 


The above code produces the following output: 


OFileDialog object 


A File Dialog demo =- O 


Text in selected file will be displayed in TextEdit control. 
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E > File Dialog demo = O X 


import sys 

from PyQt5.QtCore import + 
from PyQt5.QtGui import + 
from PyQt5.QtWidgets import + 


dass menudemo(QMainWindow): 
def _init__ (self, parent = None): 


super(menudemo, self). _init__ (parent) 


layout = QHBoxLayout() 
bar = self. menuBar() 

file = bar.addMenu( File”) 
file.addAction("New”) 


74 
tutorialspoint 


SIiIMPLYEASYLEARNING 


PyQt 


QTab Widget 


If a form has too many fields to be displayed simultaneously, they can be arranged in 
different pages placed under each tab of a Tabbed Widget. The QTabWidget provides a 
tab bar and a page area. The page under the first tab is displayed and others are hidden. 
The user can view any page by clicking on the desired tab. 


Following are some of the frequently used methods of QTabWidget class: 


Sr.No. Methods €: Description 


addTab() 

i Adds a tab associated with a widget page 
insertTab() 

j Inserts a tab with the page at the desired position 
removeTab() 

j Removes tab at given index 
setCurrentIndex() 

Ñ Sets the index of the currently visible page as current 
setCurrentWidget() 

] Makes the visible page as current 
setTabBar() 

i Sets the tab bar of the widget 
setTabPosition() 
Position of the tabs are controlled by the values 
QTabWidget.North above the pages 

/ QTabWidget.South below the pages 
QTabWidget.West to the left of the pages 
QTabWidget.East to the right of the pages 

E setTabText() 


Defines the label associated with the tab index 


The following signals are associated with QTabWidget object: 
Sr.No. Methods €: Description 


currentChanged() 


Whenever the current page index changes 
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tabClosedRequested() 


When the close button on the tab is clicked 


Example 


In the following example, the contents of a form are grouped in three categories. Each 
group of widgets is displayed under a different tab. 


Top level window itself is a QTabWidget. Three tabs are added into it. 


self.addTab(self.tab1,"Tab 1") 
self.addTab(self.tab2,"Tab 2") 
self.addTab(self.tab3,"Tab 3") 


Each tab displays a sub form designed using a layout. Tab text is altered by the statement. 


self.setTabText(0,"Contact Details”) 
self.setTabText(1,"Personal Details”) 


self.setTabText(2,"Education Details”) 


The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 


class tabdemo(QTabWidget): 
def _ init (self, parent = None): 


super(tabdemo, self). init _ (parent) 


self.tab1 = QuWidget() 
self.tab2 = QuWidget() 
self.tab3 = QWidget() 


self.addTab(self.tab1,"Tab 1") 
self.addTab(self.tab2,"Tab 2") 
self.addTab(self.tab3,"Tab 3") 
self .tab1UI() 
self.tab2UI() 
self .tab3UI() 
self.setWindowTitle("tab demo") 


tutorialspoint 


PyQt 


def tab1UlI(self): 
layout = QFormLayout() 
layout .addRow("Name",QLineEdit()) 
layout.addRow("Address",QLineEdit()) 
self.setTabText(0,"Contact Details”) 
self.tab1.setLayout(layout) 


def tab2UlI(self): 
layout = QFormLayout() 
sex = QHBoxLayout() 
sex.addWidget(QRadioButton("Male")) 
sex.addWidget(QRadioButton("Female")) 
layout .addRow(QLabel("Sex"),sex) 
layout.addRow("Date of Birth",QLineEdit()) 
self.setTabText(1,"Personal Details") 
self.tab2.setLayout(layout) 


def tab3UlI(self): 
layout = QHBoxLayout () 
layout .addWidget(QLabel("subjects”)) 
layout .addWidget(QCheckBox("Physics")) 
layout .addWidget(QCheckBox("Maths")) 
self.setTabText(2,"Education Details”) 
self.tab3.setLayout(layout) 


def main(): 
app = QApplication(sys.argv) 
ex = tabdemo() 
ex.show() 


sys.exit(app.exec_()) 


All three tabs are shown in the following output: 
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A” tab demo = O X ñ” tab demo = O X R' tab demo = O X 
Contact Details Personal Details »: Personal Details Education Detail |» | Personal Details Education Details 4 
Name i ] Sex O Male O Female 

Address | Date of Birth [ subjects [O] Physics [] Maths 


QStackedWidget 


Functioning of QStackedWidget is similar to QTabWidget. It also helps in the efficient 
use of window's client area. 


QStackedWidget provides a stack of widgets, only one of which can be viewed at a time. 
It is a useful layout built on top of QStackedLayout. 


Example 
A parent QStackedWidget object is populated with more than one child widget. 


self.Stack = QStackedWidget (self) 
self.stack1 = QWidget() 
self.stack2 = QuWidget() 
self.stack3 = QuWidget() 


self.Stack.addWidget (self.stack1) 
self.Stack.addWidget (self.stack2) 
self.Stack.addWidget (self.stack3) 


Each child widget can have its own layout of form elements. QStackedWidget on its own 
cannot switch between the pages. It is linked with the currently selected index of 
QListWidget. 


self.leftlist = QListWidget () 
self.leftlist.insertltem (0, 'Contact' ) 
self.leftlist.insertltem (1, 'Personal' >) 
self.leftlist.insertItem (2, 'Educational' ) 


self.leftlist.currentRowChanged.connect(self.display) 


Here, the currentRowChanged() signal of QListWidget is connected to display() 
function, which changes the view of stacked widget. 


def display(self,i): 
self.Stack.setCurrentIndex(i) 


The complete code is as follows: 


import sys EN 
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from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class stackedExample(QWidget): 


def _ init (self): 
super(stackedExample, self).  init_ () 
self.leftlist = QListWidget () 
self.leftlist.insertItem (0, 'Contact' ) 
self.leftlist.insertItem (1, 'Personal' ) 
self.leftlist.insertItem (2, 'Educational' ) 


self.stack1 = Quidget() 
self.stack2 = Quidget() 
self.stack3 = Quidget() 


self.stack1UI() 
self.stack2UI() 
self.stack3UI() 


self.Stack = QStackedWidget (self) 
self.Stack.addWidget (self.stack1) 
self.Stack.addWidget (self.stack2) 
self.Stack.addWidget (self.stack3) 


hbox = QHBoxLayout(self) 
hbox.addWidget(self.leftlist) 
hbox.addWidget(self.Stack) 


self.setLayout(hbox) 
self.leftlist.currentRowChanged.connect(self.display) 
self.setGeometry(300, 50, 10,10) 
self.setWindowTitle('StackedWidget demo' >) 

self .show() 


def stack1UI(self): 
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layout = QFormLayout() 

layout .addRow("Name",QLineEdit()) 
layout.addRow("Address",QLineEdit()) 
tself.setTabText(0,"Contact Details") 


self.stack1.setLayout(layout) 


def stack2UI(self): 
layout = QFormLayout() 
sex = QHBoxLayout() 
sex.addWidget(QRadioButton("Male")) 
sex.addWidget(QRadioButton("Female")) 
layout .addRow(QLabel("Sex"),sex) 
layout.addRow("Date of Birth",QLineEdit()) 


self.stack2.setLayout(layout) 


def stack3UI(self): 
layout = QHBoxLayout() 
layout .addWidget(QLabel("subjects”)) 
layout .addWidget(QCheckBox("Physics”)) 
layout .addWidget(QCheckBox("Maths")) 
self.stack3.setLayout(layout) 


def display(self,i): 
self.Stack.setCurrentIndex(i) 


def main(): 
app = QApplication(sys.argv) 
ex = stackedExample() 
sys.exit(app.exec_()) 


The above code produces the following output: 
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Contact 
Personal 
Educational 


Contact 
Personal 


Educational 


Contact 


Personal subjects [] Physics [] Maths 


Educational 
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QSplitter Widget 


This is another advanced layout manager which allows the size of child widgets to be 
changed dynamically by dragging the boundaries between them. The Splitter control 
provides a handle that can be dragged to resize the controls. 


The widgets in a QSplitter object are laid horizontally by default although the orientation 
can be changed to Qt.Vertical. 


Following are the methods and signals of QSplitter class: 


Sr.No. Methods €: Description 


addWidget() 

: Adds the widget to splitter's layout 
indexO0f() 

j Returns the index of the widget in the layout 
insetWidget() 

j Inserts a widget at the specified index 
setOrientation() 

ú Sets the layout of splitter to Qt.Horizontal or Qt.Vertical 
setSizes() 

j Sets the initial size of each widget 
count() 

6 


Returns the number of widgets in splitter widget 


splitterMoved() is the only signal emitted by QSplitter object whenever the splitter 
handle is dragged. 


Example 


The following example has a splitter object, splitteri, in which a frame and QTextEdit 
object are horizontally added. 


topleft = QFrame() 

textedit = QTextEdit() 
splitter1.addWidget(topleft) 
splitter1.addWidget(textedit) 


This splitter object splitteri and a bottom frame object are added in another splitter, 
splitter2, vertically. The object splitters is finally added in the top level window. 


bottom = QFrame() 
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splitter2 = QSplitter(Qt.Vertical) 
splitter2.addWidget(splitter1) 
splitter2.addWidget(bottom) 


hbox.addWidget(splitter2) 
self.setlayout(hbox) 


The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class Example(QWidget): 


def _ init (self): 
super(Example, self).  init_ () 
self .initur() 


def initul(self): 


hbox = QHBoxLayout(self) 


topleft = QFrame() 
topleft.setFrameShape(QFrame.StyledPanel) 
bottom = QFrame() 
bottom.setFrameShape(QFrame.StyledPanel) 


splitter1 = QSplitter(Qt.Horizontal) 
textedit = QTextEdit() 
splitter1.addWidget(topleft) 
splitter1.addWidget(textedit) 
splitter1.setSizes([100,200]) 


splitter2 = QSplitter(Qt.Vertical) 
splitter2.addWidget(splitter1) 
splitter2.addWidget (bottom) 
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hbox.addWidget(splitter2) 


self.setLayout(hbox) 
QApplication.setStyle(QStyleFactory.create('Cleanlooks')) 


self.setGeometry(300, 300, 300, 200) 
self.setWindowTitle('QSplitter demo') 
self.show() 


def main(): 
app = QApplication(sys.argv) 
ex = Example() 


sys.exit(app.exec_()) 


The above code produces the following output: 


2. QSplitter demo - DO Xx 


AT Spliiter handles 
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QDock Widget 


A dockable window is a subwindow that can remain in floating state or can be attached to 
the main window at a specified position. Main window object of QMainWindow class has 
an area reserved for dockable windows. This area is around the central widget. 


A dock window can be moved inside the main window, or they can be undocked to be 
moved into a new area by the user. These properties are controlled by the 
following QDockWidget class methods: 


Sr.No. Methods €: Description 


setWidget() 


Sets any QWidget in the dock window's area 


setFloating() 


If set to true, the dock window can float 


setAllowedAreas() 


Sets the areas to which the window can be docked 
LeftDockWidgetArea 

E RightDockWidgetArea 
TopDockWidgetArea 
BottomDockWidgetArea 
NoDockWidgetArea 
setFeatures() 
Sets the features of dock window 
DockWidgetClosable 

4 DockWidgetMovable 
DockWidgetFloatable 
DockWidgetVerticalTitleBar 


NoDockWidgetFeatures 


Example 


In the following example, top level window is a QMainWindow object. A QTextEdit object 
is its central widget. 


self.setCentralWidget(QTextEdit()) 


A dockable window is first created. 
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self.items = QDockWidget("Dockable", self) 


A QListWidget object is added as a dock window. 


self.listWidget = QListWidget() 
self.listWidget.addItem("item1") 
self.listWidget.addItem("item2") 
self.listWidget.addItem("item3") 
self.items.setWidget(self.listWidget) 


Dockable object is placed towards the right side of the central widget. 


self.addDockWidget(Qt.RightDockWidgetArea, self.items) 


The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class dockdemo(QMainWindow) : 
def _ init (self, parent = None): 


super(dockdemo, self). init _ (parent) 


layout = QHBoxLayout () 

bar = self.menuBar() 

file = bar.addMenu("File") 
file.addAction("New") 
file.addAction("save" 


file.addAction("quit") 


self.items = QDockWidget("Dockable", self) 
self.listWidget = QListWidget() 
self.listWidget.addItem("item1") 
self.listWidget.addItem("item2") 
self.listWidget.addItem("item3") 


self.items.setWidget(self.listWidget) 
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self.items.setFloating(False) 
self.setCentralWidget(QTextEdit()) 
self.addDockWidget(Qt.RightDockWidgetArea, self.items) 
self.setLayout(layout) 

self.setWindowTitle("Dock demo”) 


def main(): 
app = QApplication(sys.argv) 
ex = dockdemo() 
ex.show() 
sys.exit(app.exec_()) 
if _name__ == '  main_': 


main() 


The above code produces the following output. Click on Dock icon to undock the ListWidget 
window. Double click to dock again: 


RA Dock demo — O Xx 
File 


Dockable $ x 


item1 
item2 


item3 


KA" Dock demo —- O X 
File 
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QStatusBar Widget 


QMainWindow object reserves a horizontal bar at the bottom as the status bar. It is used 
to display either permanent or contextual status information. 


There are three types of status indicators: 


Temporary: Briefly occupies most of the status bar. For example, used to explain tool tip 
texts or menu entries. 


Normal: Occupies part of the status bar and may be hidden by temporary messages. For 
example, used to display the page and line number in a word processor. 


Permanent: It is never hidden. Used for important mode indications. For example, some 
applications put a Caps Lock indicator in the status bar. 


Status bar of QMainWindow is retrieved by statusBar() function. setStatusBar() function 
activates it. 


self.statusBar = QStatusBar() 
self.setStatusBar(self.statusBar) 


Methods of OStatusBar Class 
Sr.No. Methods €: Description 


addWidget() 

j Adds the given widget object in the status bar 
addPermanentWidget() 

¿ Adds the given widget object in the status bar permanently 
showMessage() 

7 Displays a temporary message in the status bar for a specified time interval 
clearMessage() 

Ñ Removes any temporary message being shown 
removeWidget() 

, Removes specified widget from the status bar 

Example 


In the following example, a top level QMainWindow has a menu bar and a QTextEdit object 
as its central widget. 


Window's status bar is activated as explained above. 


Menu's triggered signal is passed to processtrigger() slot function. If 'show” action is 
triggered, it displays a temporary message in the status bar as: 
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if (q.text() == "show"): 


self.statusBar.showMessage(q.text()+" is clicked",2000) 


The message will be erased after 2000 milliseconds (2 sec). If*add' action is triggered, a 
button widget is added. 


if q.text() == "add": 
self.statusBar.addWidget(self.b) 


Remove action will remove the button from the status bar. 


if q.text() == "remove": 
self.statusBar.removeWidget(self.b) 


self.statusBar.show() 


The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class statusdemo(QMainWindow) : 
def _ init (self, parent = None): 


super(statusdemo, self).  init_ (parent) 


bar = self.menuBar() 

file = bar.addMenu("File") 

file.addAction("show") 

file.addAction("add”) 

file.addAction("remove" 
file.triggered[QAction].connect(self.processtrigger) 


self.setCentralWidget(QTextEdit()) 


self.statusBar = QStatusBar() 

self.b = QPushButton("click here”) 
self.setWindowTitle("QStatusBar Example") 
self.setStatusBar(self.statusBar) 
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def processtrigger(self,q): 


if (q.text() == "show"): 
self.statusBar.shouwMessage(q.text()+" is clicked",2000) 


if q.text() == "add": 
self.statusBar.addWidget(self.b) 


if q.text() == "remove": 
self.statusBar.removeWidget(self.b) 


self.statusBar.show() 


def main(): 
app = QApplication(sys.argv) 
ex = statusdemo() 
ex.show() 


sys.exit(app.exec_()) 


main() 


The above code produces the following output. Status bar shows caption of selected menu 
button: 


A” OStatusBar Example — O A” OStatusBar Example  — O Xx 
File File 


add 


remove 


show is clicked 
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QList Widget 


QListWidget class is an item-based interface to add or remove items from a list. Each 
item in the list is a QListWidgetltem object. ListWidget can be set to be multiselectable. 


Following are the frequently used methods of QListWidget class: 


Sr.No. Methods 8: Description 


additem() 
i Adds QListWidgetltem object or string in the list 
addlIltems() 
] Adds each ¡tem in the list 
insertltem() 
j Inserts item at the specified index 
clear() 
4 
Removes contents of the list 
setCurrentltem() 
] Sets currently selected item programmatically 
E sortltems() 


Rearranges items in ascending order 
Following are the signals emitted by QListWidget: 
Sr.No. Methods €: Description 


currentltemChanged() 


1 
Whenever current item changes 
itemClicked() 
2 
Whenever an ¡tem in the list is clicked 
Example 


The following example shows the click event being captured to pop up a message box. 


from PyQt4.QtGui import * 
from PyQt4.QtCore import * 


import sys 


class myListWidget(QListWidget): 
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def Clicked(self,item): 


QMessageBox.information(self, "ListWidget", "You clicked: "+item.text()) 


def main(): 
app = QApplication(sys.argv) 
listWidget = myListWidget() 


HResize width and height 
listWidget.resize(300,120) 


listWidget.addItem("Item 1"); 
listWidget.addItem("Item 2"); 
listWidget.addItem("Item 3"); 
listWidget.addItem("Item 4"); 


listWidget.setWindowTitle('PyQT QListwidget Demo') 
listWidget.itemClicked.connect(listWidget.Clicked) 


listWidget.show() 
sys.exit(app.exec_()) 


if  name__ == ' main_': 


main() 


The above code produces the following output. Status bar shows caption of selected menu 
button: 


5 pyar que X 
—————_1 E ListWidget Xx + 


Item 1 


Item 2 You clicked: ltem 3 
Item 3 
Item 4 
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QScrollBar Widget 


A QScrollbar control enables the user to access parts of the document that is outside the 
viewable area. It provides visual indicator to the current position. It has a slider by which 
a value between a preset range is set in analogous fashion. This value is usually correlated 
to bring a hidden data inside the viewport. 


The QScrollbar has four controls: 
a: slider 
b: Two Scroll arrows Scroll Bar 


c: Page control 


Following signals of QScrollBar class are frequently used: 


Sr.No.|Methods 8: Description 
valueChanged() 

Ñ When the scrollbar's value changes 
sliderMoved() 

j When the user drags the slider 

Example 


In the following example, three scroll bars are placed to control RGB values of font color 
for the text displayed in a label. The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class Example(QWidget): 


def _ init (self): 
super(Example, self).  init_ () 
self .initur() 


def initul(self): 
vbox = QVBoxLayout(self) 
self.setLayout(vbox) 
hbox = QHBoxLayout () 
self.11 = QLabel("Drag scrollbar sliders to change color") 
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self.11.setFont(QFont("Arial",16)) 


hbox.addWidget(self.11) 
self.s1 = QScrollBar() 
self.s1.setMaximum(255) 


self.s1.sliderMoved.connect(self.sliderval) 
self.s2 = QScrollBar() 
self.s2.setMaximum(255) 


self.s2.sliderMoved.connect(self.sliderval) 


self.s3 = QScrollBar() 
self.s3.setMaximum(255) 


self.s3.sliderMoved.connect(self.sliderval) 


hbox.addWidget(self.s1) 
hbox.addWidget(self.s2) 
hbox.addWidget(self.s3) 
vbox.addLayout(hbox) 


self.setGeometry(300, 300, 300, 200) 
self.setWindowTitle('QSplitter demo') 
self .show() 


def sliderval(self): 
palette = QPalette() 
c = QColor(self.s1.value(),self.s2.value(), self.s3.value(),255) 
palette.setColor(QPalette.Foreground,c) 
self.11.setPalette(palette) 


def main(): 


app = QApplication(sys.argv) 
ex = Example() 


sys.exit(app.exec_()) 
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main() 


The above code produces the following output: 


A QScrollbar demo — O Xx 


Drag scrollbar sliders to change color 


QCalendar Widget 


QCalendar widget is a useful date picker control. It provides a month-based view. The 
user can select the date by the use of the mouse or the keyboard, the default being today's 
date. Calendar's date range can also be stipulated. 


Given below are the most commonly used methods of QCalendar: 


Sr.No. Methods €: Description 


setDateRange() 
Ñ Sets the lower and upper date available for selection 
setFirstDayOfWeek() 
Determines the day of the first column in the calendar 
The predefined day constants are: 
Qt.Monday 
Qt.Tuesday 
] Qt.Wednesday 
Qt.Thursday 
Qt.Friday 
Qt.Saturday 
Qt.Sunday 
s setMinimumDate() 


Sets the lower date for selection 
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setMaximumbDate() 

úl Sets the upper date for selection 
setSelectedDate() 

j Sets a QDate object as the selected date 
showToday() 

' Shows the month of today 
selectedDate() 

/ Retrieves the selected date 
setGridvisible() 

Ñ Turns the calendar grid on or off 

Example 


The following example has a calendar widget and a label which displays the currently 
selected date. The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class Example(QWidget): 


def _ init (self): 


super(Example, self).  init_ () 
self .initur() 

def initul(self): 
cal = QCalendarWidget(self) 
cal.setGridVisible(True) 
cal.move(20, 20) 


cal.clicked[QDate].connect(self.showDate) 


self.1b1 = QLabel(self) 
date = cal.selectedDate() 
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self.1b1.setText(date.toString()) 
self.1b1.move(100, 250) 


self.setGeometry(100,100,300,300) 
self.setWindowTitle('Calendar' >) 
self.show() 


def showDate(self, date): 


self.1b1.setText(date.toString()) 


def main(): 


app = QApplication(sys.argv) 


ex = Example() 


sys.exit(app.exec_()) 


if _ name__ == '_ main_': 


main() 


The above code produces the following output. Selected date is displayed on the label: 


E Calendar = O Xx 
e December, 2019 Ed 
Sun Mon Tue Wed Thu Fri Sat 

48 24 5 26 27 28 29 3 


Sat Dec 14 2019 
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9. PyQt5 — QDialog Class 


A QDialog widget presents a top level window mostly used to collect response from the 
user. It can be configured to be Modal (where ¡it blocks ¡ts parent window) 
or Modeless (the dialog window can be bypassed). 


PyQt API has a number of preconfigured Dialog widgets such as InputDialog, FileDialog, 
FontDialog, etc. 


Example 


In the following example, WindowModality attribute of Dialog window decides whether 
itis modal or modeless. Any one button on the dialog can be set to be default. The dialog 
is discarded by QDialog.reject() method when the user presses the Escape key. 


A PushButton on a top level QWidget window, when clicked, produces a Dialog window. A 
Dialog box doesn't have minimize and maximize controls on its title bar. 


The user cannot relegate this dialog box in the background because its WindowModality ¡is 
set to ApplicationModal. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 


def window(): 
app = QApplication(sys.argv) 
w = Quidget() 
btn = QPushButton(w) 
btn.setText("Hello World!") 
btn.move(1090,50) 
btn.clicked.connect(showdialog) 
w.setWindowTitle("PyQt Dialog demo") 
w.show() 


sys.exit(app.exec_()) 


def showdialog(): 
dlg = QDialog() 
b1 = QPushButton("ok",dlg) 
b1.move(50,50) 
dlg.setWindowTitle("Dialog") 
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dlg.setWindowModality(Qt.ApplicationModal) 
dlg.exec_() 
if  name__ == '  main_': 


window( ) 


The above code produces the following output. Click on button in main window and dialog 


box pops up: 
A” PyQt Dialog demo => O 
Hello World! 
ñ' Dialog ? X 
e 
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10. PyQt5 — QMessageBox 


QMessageBox is a commonly used modal dialog to display some informational message 
and optionally ask the user to respond by clicking any one of the standard buttons on it. 
Each standard button has a predefined caption, a role and returns a predefined 
hexadecimal number. 


Important methods and enumerations associated with QMessageBox class are given in the 
following table: 


Sr.No. Methods 8 Description 


setIcon() 


Displays predefined icon corresponding to severity of the message 
Question 
Information 
Warning 


Critical 
setText() 
Sets the text of the main message to be displayed 
setInformativeText() 
Displays additional information 
setDetailText() 
Dialog shows a Details button. This text appears on clicking it 
setTitle() 
Displays the custom title of dialog 
setStandardButtons() 
List of standard buttons to be displayed. Each button is associated with 
QMessageBox.Ok 0x00000400 
QMessageBox.Open 0x00002000 
QMessageBox.Save 0x00000800 
QMessageBox.Cancel 0x00400000 
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QMessageBox.Close 0x00200000 
QMessageBox.Yes 0x00004000 
QMessageBox.No 0x00010000 
QMessageBox.Abort 0x00040000 
QMessageBox.Retry 0x00080000 
QMessageBox.Ignore 0x00100000 


setDefaultButton() 
7 
Sets the button as default. It emits the clicked signal if Enter is pressed 
setEscapeButton() 
8 
Sets the button to be treated as clicked if the escape key is pressed 
Example 


In the following example, click signal of the button on the top level window, the connected 
function displays the messagebox dialog. 


msg = QMessageBox() 

msg.setIcon(QMessageBox. Information) 

msg.setText("This is a message box") 
msg.setInformativeText("This is additional information") 
msg.setWindowTitle("MessageBox demo") 


msg.setDetailedText("The details are as follows:") 


setStandardButton() function displays desired buttons. 


msg.setStandardButtons(QMessageBox.Ok | QMessageBox.Cancel) 


buttonClicked() signal is connected to a slot function, which identifies the caption of source 
of the signal. 


msg .buttonClicked.connect(msgbtn) 


The complete code for the example is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


def window(): 
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app = QApplication(sys.argv) 
Quidget() 


W 


QPushButton(w) 


b.setText("Show message!") 


b.move(190,50) 
b.clicked.connect(showdialog) 
w.setWindowTitle("PyQt MessageBox demo") 
w.show() 


sys.exit(app.exec_()) 


def showdialog(): 
msg = QMessageBox() 


msg.setIcon(QMessageBox.Information) 


msg.setText("This is a message box") 
msg.setInformativeText("This is additional information") 
msg.setWindowTitle("MessageBox demo") 
msg.setDetailedText("The details are as follows:") 

msg .setStandardButtons(QMessageBox.Ok | QMessageBox.Cancel) 
msg.buttonClicked.connect(msgbtn) 


retval = msg.exec_() 


def msgbtn(i): 
print ("Button pressed is:",i.text()) 


if  name__ == ' main_': 


window( ) 


The above code produces the following output. Message Box pops up when main windows” 
button is clicked: 
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E | PyQt MessageBox demo  — O X E ' MessageBox demo X 


This is a message box 


This is additional information 


oK Hide Details... Cancel | 


The details are as follows; 


Show message! 


If you click on Ok or Cancel button on MessageBox, the following output is produced on 
the console: 


Button pressed is: OK 


Button pressed is: Cancel 
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11. PyQt5 — Multiple Document Interface 


A typical GUI application may have multiple windows. Tabbed and stacked widgets allow 
to activate one such window at a time. However, many a times this approach may not be 
useful as view of other windows is hidden. 


One way to display multiple windows simultaneously is to create them as independent 
windows. This is called as SDI (single Document Interface). This requires more memory 
resources as each window may have its own menu system, toolbar, etc. 


MDI (Multiple Document Interface) applications consume less memory resources. The 
sub windows are laid down inside main container with relation to each other. The container 
widget is called QMdiArea. 


QMdiArea widget generally occupies the central widget of QMainWondow object. Child 
windows in this area are instances of QMdiSubWindow class. It is possible to set any 
QWidget as the internal widget of subWindow object. Sub-windows in the MDI area can 
be arranged in cascaded or tile fashion. 


The following table lists important methods of QMdiArea class and QMdiSubWindow class: 


Sr.No. Methods 8: Description 


addSubWindow() 


] Adds a widget as a new subwindow in MDI area 
removeSubWindow() 

d Removes a widget that is internal widget of a subwindow 
setActiveSubWindow() 

7 Activates a subwindow 
cascadeSubWindows() 

Ñ Arranges subwindows in MDiArea in a cascaded fashion 
tileSubWindows() 

] Arranges subwindows in MDiArea in a tiled fashion 
closeActiveSubWindow() 

é Closes the active subwindow 
subWindowList() 

j Returns the list of subwindows in MDI Area 

a setWidget() 


Sets a QWidget as an internal widget of a QMdiSubwindow instance 
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QMdiArea object emits subWindowActivated() signal whereas windowStateChanged() 
signal is emitted by QMdisubWindow object. 


Example 


In the following example, the top level window comprising of QMainWindow has a menu 
and MdiArea. 


self.mdi = QMdiArea() 
self.setCentralWidget(self.mdi) 
bar = self.menuBar() 


file = bar.addMenu("File”) 


file.addAction("New") 
file.addAction("cascade”) 


file.addAction("Tiled”) 


Triggered() signal of the menu is connected to windowaction() function. 


file.triggered[QAction].connect(self.windowaction) 


The new action of menu adds a subwindow in MDI area with a title having an incremental 
number to it. 


MainWindow.count = MainWindow.count+1 

sub = QMdiSubWindow( ) 

sub.setWidget(QTextEdit()) 
sub.setWindowTitle("subwindow"+str(MainWindow.count)) 
self.mdi.addSubWindow(sub) 

sub.show() 


Cascaded and tiled buttons of the menu arrange currently displayed subwindows in 
cascaded and tiled fashion respectively. 


The complete code is as follows: 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class MainWindow(QMainWindow) : 


count = 0 
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def _ init (self, parent = None): 
super(MainWindow, self).  init_ (parent) 
self.mdi = QMdiArea() 
self.setCentralldidget(self.mdi) 


bar = self.menuBar() 


file = bar.addMenu("File") 

file.addAction("New") 

file.addAction("cascade") 

file.addAction("Tiled”) 
file.triggered[QAction].connect(self.windowaction) 


self.setWindowTitle("MDI demo”) 


def windowaction(self, q): 


print ("triggered”) 


if q.text() == "New": 
MainWindow.count = MainWindow.count+1 
sub = QMdiSubWindow() 
sub.setWidget(QTextEdit()) 
sub.setWindowTitle("subwindow"+str(MainWindow.count)) 
self .mdi.addSubWindow(sub) 
sub.show() 


if q.text() == "cascade": 


self.mdi.cascadeSubWindows( ) 


if q.text() == "Tiled": 
self.mdi.tileSubWindows() 


def main(): 
app = QApplication(sys.argv) 
ex = MainWindow() 
ex.show() 


sys.exit(app.exec_()) 
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main() 


Run above code and three windows in cascased and tiled formation: 


MDI demo 


E MDI demo - | Xx 
File 
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E MDI demo - [1] Xx 


File 
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12. PyQt5 — Drag €: Drop 


The provision of drag and drop ¡s very intuitive for the user. It is found in many desktop 
applications where the user can copy or move objects from one window to another. 


MIME based drag and drop data transfer is based on QDrag class. QMimeData objects 
associate the data with their corresponding MIME type. It is stored on clipboard and then 
used in the drag and drop process. 


The following QMimeData class functions allow the MIME type to be detected and used 
conveniently. 


Tester Getter Setter MIME Types 
hasText()  text() setText() text/plain 
hasHtml()  html() setHtml() text/html 
hasUrls()  urls() setUrls() text/uri-list 


hasImage() imageData() setimageData() image/ * 


hasColor() colorData() setColorData() application/x-color 


Many QWidget objects support the drag and drop activity. Those that allow their data to 
be dragged have setDragEnabled() which must be set to true. On the other hand, the 
widgets should respond to the drag and drop events in order to store the data dragged 
into them. 


. DragEnterEvent provides an event which is sent to the target widget as dragging 
action enters it. 

. DragMoveEvent ¡s used when the drag and drop action is in progress. 

e. DragLeaveEvent is generated as the drag and drop action leaves the widget. 

e. DropEvent, on the other hand, occurs when the drop is completed. The event's 


proposed action can be accepted or rejected conditionally. 


Example 


In the following code, the DragEnterEvent verifies whether the MIME data of the event 
contains text. If yes, the event's proposed action is accepted and the text is added as a 
new item in the ComboBox. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 
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class combo(QComboBox) : 


def _ init (self, title, parent): 


super(combo, self).  init_ ( parent) 


self.setAcceptDrops(True) 


def dragEnterEvent(self, e): 


print (e) 


if e.mimeData().hasText(): 
e.accept() 
else: 


e.ignore() 


def dropEvent(self, e): 
self.addItem(e.mimeData().text()) 


class Example(QWidget): 


def _ init (self): 


super(Example, self).  init_ () 


self .initur() 


def initul(self): 
lo = QFormLayout() 


lo.addRow(QLabel("Type some text in textbox and drag it into combo box")) 


edit = QLineEdit() 
edit.setDragEnabled(True) 

com = combo("Button", self) 
lo.addRow(edit,com) 

self.setLayout(lo) 
self.setWindowTitle('Simple drag and drop') 
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def main(): 
app = QApplication(sys.argv) 
ex = Example() 
ex.show() 


app.exec_() 


The above code produces the following output: 


| Simple drag and drop ed O 


Type some text in textbox and drag it into combo box 


po  ] 


A” Simple drag and drop ES O 


Type some text in textbox and drag ¡tinto combo box 


Hello Python Hello Python 
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13. PyQt5 — Database Handling 


PyQt5 library contains QtSql module. It is an elaborate class system to communicate with 
many SQL based databases. Its QSqlDatabase provides access through a Connection 
object. Following is the list of currently available SQL drivers: 


Sr.No. Driver Type €: Description 


QDB2 
1 
IBM DB2 
QIBASE 
2 
Borland InterBase Driver 
QMYSQL 
3 
MySQL Driver 
QOCI 
4 
Oracle Call Interface Driver 
QODBC 
5 
ODEC Driver (includes Microsoft SQL Server) 
QPSQL 
6 
PostgreSQL Driver 
QSQLITE 
7 
SQLite version 3 or above 
QSQLITE2 
8 
SQLite version 2 
Example 
For this chapter, a connection with a SQLite database is established using the static 
method: 


db = QtSql.QSqlDatabase.addDatabase( 'QSQLITE"') 
db.setDatabaseÑame('sports.db') 


Other methods of QSqglDatabase class are as follows: 
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Sr.No. Methods €: Description 


setDatabaseName() 

¡ Sets the name of the database with which connection is sought 
setHostName() 

ñ Sets the name of the host on which the database is installed 
setUserName() 

] Specifies the user name for connection 
setPassword() 

Ñ Sets the connection object's password if any 
commit() 

¡ Commits the transactions and returns true if successful 
rollback() 

j Rolls back the database transaction 
close() 

7 


Closes the connection 


QSq|Query class has the functionality to execute and manipulate SQL commands. Both 
DDL and DML type of SQL queries can be executed. First step is to create SQlite database 
using the following statements: 


db = QSqlDatabase.addDatabase('QSQLITE') 
db.setDatabaseÑame('sportsdatabase.db' >) 


Next, obtain Query object with QSqlQuery() method and call its most important 
method exec_(), which takes as an argument a string containing SQL statement to be 
executed. 


query = QtSql.QSqlQuery() 
query.exec_("create table sportsmen(id int primary key, 


" "firstname varchar(20), lastname varchar(20))") 


The following script creates a SQLite database sports.db with a table of sportsperson 
populated with five records. 


import sys 

from PyQt5.QtSql import * 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 


113 


tutorialspoint 


PyQt 


from PyQt5.QthWidgets import * 


def createDB(): 
db = QSqlDatabase.addDatabase('QSQLITE') 
db.setDatabaseName('sportsdatabase.db') 


if not db.open(): 
msg = QMessageBox( ) 
msg.setIcon(QMessageBox.Critical) 
msg.setText("Error in Database Creation") 
retval = msg.exec_() 


return False 


query = QSqlQuery() 
query.exec_ ("create table sportsmen(id int primary key, " 


"firstname varchar(20), lastname varchar(20))") 


query.exec_("insert into sportsmen values(101, 'Roger', 'Federer')") 
query.exec_ ("insert into sportsmen values(182, 'Christiano', 'Ronaldo')") 
query.exec_ ("insert into sportsmen values(103, 'Ussain', 'Bolt')") 
query.exec_("insert into sportsmen values(1094, 'Sachin', 'Tendulkar')") 
query.exec_ ("insert into sportsmen values(105, 'Saina', 'Nehwal')") 
return True 

if  name__ == ' main_': 
app = QApplication(sys.argv) 
createDB() 


To confirm that the SQLite datbase is created with above records added in sportsmen table 
in it, use a SQLite Gui utility called SQLiteStudio. 
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|  SOLiteStudio (3.1.1) - [sportsmen (sports)] — O X 
[E Database Structure View Tools Help - ¡5D Xx 
ESAS mom | 
A 30: 0: 3: Y: Mr e s| » ly» m7 
| Databases $X Structure Data Constraints Indexes Triggers DDL 
Grid view Form view 
< registrations (SQL a -D0000O0NBDagáñ |» 
= college (SQlite3) || = 
3) sports (SQlite 3) id firstname  lastname 
Y 1 101 Roger Federer 
2 102 Christiano Ronaldo 
EE Views 3 103 Ussain Bolt 
- 104 Sachin Tendulkar 
5 105 Saina Nehwal 
ar J 
1 sportsmen (sports) 


QSqlTableModel class in PyQt is a high-level interface that provides editable data model 
for reading and writing records in a single table. This model is used to populate 
a QTableView object. It presents to the user a scrollable and editable view that can be 
put on any top level window. 


A QSqlTableModel object is declared in the following manner: 


model = QtSql.QSqlTableModel() 


Its editing strategy can be set to any of the following: 


QSqliTableModel.OnFieldChange All changes will be applied immediately 


Changes will be applied when the user selects a 


QSqliTableModel.OnNRowChange different row 


All changes will be cached until either submitAll() 


QSqlTableModel.OnManualSubmit or revertAll() is called 


Example 


In the following example, sportsperson table is used as a model and the strategy is set 
as: 


model.setTable( 'sportsmen') 


model .setEditStrategy(QtSql.QSqlTableModel.OnFieldChange) 


model.select() 


QTableView class is part of Model/View framework in PyQt. The QTableView object is 
created as follows: 
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view = QtGui.QTableView() 
view.setModel(model) 
view.setWindowTitle(title) 


return view 


This QTableView object and two QPushButton widgets are added to the top level QDialog 
window. Clicked() signal of add button is connected to addrow() which performs 
insertRow() on the model table. 


button.clicked.connect(addrow) 
def addrow(): 
print model.rowCount() 
ret = model.insertRows(model.rowCount(), 1) 


print ret 


The slot associated with the delete button executes a lambda function that deletes a row, 
which is selected by the user. 


btn1.clicked.connect(lambda: model.removeRow(view1.currentIndex().row())) 


The complete code is as follows: 


import sys 

from PyQt5.QtSql import * 
from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


def initializeModel(model): 
model.setTable('sportsmen') 
model .setEditStrategy(QSqlTableModel.OnFieldChange) 
model.select() 
model.setHeaderData(0, Qt.Horizontal, "ID") 
model.setHeaderData(1, Qt.Horizontal, "First name”) 


model.setHeaderData(2, Qt.Horizontal, "Last name") 


def createView(title, model): 
view = QTableView() 
view.setModel(model) 
view.setWindowTitle(title) 


return view 
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def addrow(): 
print (model.rowCount()) 
ret = model.insertRows(model.rowCount(), 1) 


print (ret) 


def findrow(i): 


delrow = i.row() 


app = QApplication(sys.argv) 

db = QSqlDatabase.addDatabase('QSQLITE') 
db.setDatabaseName('sportsdatabase.db') 
model = QSqlTableModel() 

delrow = -1 


initializeModel(model) 


viewl = createView("Table Model (View 1)", model) 


view1.clicked.connect(findrow) 


dlg = QDialog() 
layout = QVBoxLayout() 
layout .addWidget (view1) 


button = QPushButton("Add a row") 
button.clicked.connect(addrow) 


layout .addWidget(button) 


btn1 = QPushButton("del a row") 
btn1.clicked.connect(lambda: model.removeRow(view1.currentIndex().row())) 


layout.addWidget(btn1) 


dlg.setLayout(layout) 
dlg.setWindowTitle("Database Demo") 
dlg.show() 
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sys.exit(app.exec_()) 


The above code produces the following output: 


E Database Demo ? 
1D First name Last name 

1 101 Roger Federer 

2 102 Christiano Ronaldo 

3 103 Ussain Bolt 

4 104 Sachin Tendulkar 

5 105 Saina Nehwal 

6 106 Virat Kohli 

Add a row 


Try adding and deleting a few records and go back to SQLiteStudio to confirm the 


transactions. 
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14. PyQt5 — Drawing API 


All. the QWidget classes in PyQt are sub classed from QPaintDevice class. A 
QPaintDevice is an abstraction of two dimensional space that can be drawn upon using a 
QPainter. Dimensions of paint device are measured in pixels starting from the top-left 
corner. 


QPainter class performs low level painting on widgets and other paintable devices such 
as printer. Normally, it is used in widget's paint event. The QPaintEvent occurs whenever 
the widget's appearance is updated. 


The painter is activated by calling the begin() method, while the end() method 
deactivates it. In between, the desired pattern is painted by suitable methods as listed in 
the following table. 


Sr.No. Methods 8: Description 


begin() 


j Starts painting on the target device 
drawArc() 
j Draws an arc between the starting and the end angle 
drawEllipse() 
7 Draws an ellipse inside a rectangle 
drawLine() 
Ñ Draws a line with endpoint coordinates specified 
drawPixmap() 
j Extracts pixmap from the image file and displays it at the specified position 
drawPolygon() 
' Draws a polygon using an array of coordinates 
drawRect() 
7 Draws a rectangle starting at the top-left coordinate with the given width and 
height 
drawText() 
i Displays the text at given coordinates 
fillRect() 
9 


Fills the rectangle with the QColor parameter 
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setBrush() 
10 

Sets a brush style for painting 

setPen() 
11 

Sets the color, size and style of pen to be used for drawing 
Example 


In the following code, various methods of PyQt's drawing methods are used. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class Example(QWidget): 


def _ init (self): 
super(Example, self).  init_ () 


self .inituI() 


def initul(self): 
self.text = "hello world" 
self.setGeometry(100,100, 400,300) 
self.setWindowTitle('Draw Demo') 


self.show() 


def paintEvent(self, event): 
ap = QPainter() 
ap.begin(self) 
ap.setPen(QColor(Qt.red)) 
ap.setFont(QFont('Arial', 20)) 
ap.drawText(10,50, "hello Python") 
ap.setPen(QColor(Qt.blue)) 
ap.drawLine(10,1090,1090,100) 
ap.drawRect(10,150,150,100) 
ap.setPen(QColor(Qt.yellow)) 
ap.drawEllipse(100,50,100,50) 
aqp.drawPixmap(220,10,QPixmap("pythonlogo.png")) 
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ap.fillRect(20,175,130,70,QBrush(Qt.SolidPattern)) 
ap.end() 


def main(): 
app = QApplication(sys.argv) 
ex = Example() 
sys.exit(app.exec_()) 

if _name__ == '_main_': 


main() 


The above code produces the following output: 


E Draw Demo = O Xx 


hello Python 
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15. PyQt5 — Brush Style Constants 


In this chapter, we shall learn Brush Style Constants. 


Brush Style Constants 


Given below are the Brush Style Constants: 


Qt.NoBrush No brush pattern. 
Qt.SolidPattern Uniform color. 


Qt.DenseiPattern  Extremely dense pattern. Denisty 1-7 


Qt.HorPattern Horizontal lines. 
Qt.VerPattern Vertical lines. 
Qt.CrossPattern Crossing horizontal and vertical lines. 


Qt.BDiagPattern Backward diagonal lines. 
Qt.FDiagPattern Forward diagonal lines. 


Qt.DiagCrossPattern Crossing diagonal lines. 


Predefined QColor Styles 


Given below are the Predefined QColor Styles: 


Qt.NoBrush No brush pattern 
Qt.SolidPattern Uniform color 


Qt.DenseiPattern  Extremely dense brush pattern 


Qt.HorPattern Horizontal lines 
Qt.VerPattern Vertical lines 
Qt.CrossPattern Crossing horizontal and vertical lines 


Qt.BDiagPattern Backward diagonal lines 
Qt.FDiagPattern Forward diagonal lines 


Qt.DiagCrossPattern Crossing diagonal lines 
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Predefined QColor Objects 


Given below are the Predefined QColor Objects: 


Qt.white 
Qt.black 
Qt.red 
Qt.darkRed 
Qt.green 
Qt.darkGreen 
Qt.blue 
Qt.cyan 
Qt.magenta 
Qt.yellow 
Qt.darkYellow 


Qt.gray 


Custom color can be chosen by specifying RGB or CMYK or HSV values. 
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16. PyQt5 — QClipboard 


The QClipboard class provides access to system-wide clipboard that offers a simple 
mechanism to copy and paste data between applications. Its action is similar 
to QDrag class and uses similar data types. 


QApplication class has a static clipboard() method which returns reference to clipboard 
object. Any type of MimeData can be copied to or pasted from the clipboard. 


Following are the clipboard class methods that are commonly used: 


Sr.No. Methods €: Description 


clear() 

] Clears clipboard contents 
setIimage() 

: Copies QlImage into clipboard 
setMimeData() 

j Sets MIME data into clipboard 
setPixmap() 

Ñ Copies Pixmap object in clipboard 
setText() 

> Copies QString in clipboard 
text() 

6 


Retrieves text from clipboard 


Signal associated with clipboard object is: 


Sr.No. Method €: Description 


dataChanged() 
1 

Whenever clipboard data changes 
Example 


In the following example, two TextEdit objects and two Pushbuttons are added to a top 
level window. 
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To begin with the clipboard object is instantiated. Copy() method of textedit object copies 
the data onto the system clipboard. When the Paste button is clicked, it fetches the 


clipboard data and pastes it in other textedit object. 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


class Example(QWidget): 


def _ init (self): 


super(Example, self).  init_ () 


self .inituI() 


def initul(self): 


hbox = QVBoxLayout() 

self .edit1=QTextEdit() 
hbox.addWidget(self.edit1) 
self.btn1=Q0PushButton("Copy”) 
hbox.addWidget(self.btn1) 

self .edit2=QTextEdit() 
self.btn2=Q0PushButton("Paste”) 
hbox.addWidget(self.edit2) 
hbox.addWidget(self.btn2) 
self.btn1.clicked.connect(self.copytext) 
self.btn2.clicked.connect(self.pastetext) 
self.setLayout(hbox) 


self.setGeometry(300, 300, 300, 200) 
self.setWindowTitle('Clipboard')>) 
self.show() 


def copytext(self): 


tutorialspoint 


SIiIMPLYEAS 


125 


PyQt 


tclipboard.setText(self.edit1.copy()) 
self.edit1.copy() 
print (clipboard.text()) 


msg=QMessageBox() 
msg.setText(clipboard.text()+" copied on clipboard”) 
msg.exec_() 

def pastetext(self): 
self.edit2.setText(clipboard.text()) 


app = QApplication(sys.argv) 
clipboard=app.clipboard() 

ex = Example() 
ex.setWindowTitle("clipboard Example") 
sys.exit(app.exec_()) 


The above code produces the following output: 
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E clipboard Example ll O Xx 


Tutorialspoint.com 
PyQt5 Tutorial| 


E python 


PyQt5 Tutorial copied on clipboard 


KE | clipboard Example == O X 


PyQt5 Tutorial 


Paste 


mA 
A | 
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17. PyQt5 — QPixmap Class 


QPixmap class provides an off-screen representation of an image. It can be used as a 
QPaintDevice object or can be loaded into another widget, typically a label or button. 


Qt API has another similar class QImage, which is optimized for 1/O and other pixel 
manipulations. Pixmap, on the other hand, is optimized for showing it on screen. Both 
formats are interconvertible. 


The types of image files that can be read into a QPixmap object are as follows: 


BMP Windows Bitmap 

GIF Graphic Interchange Format (optional) 
JPG Joint Photographic Experts Group 
JPEG Joint Photographic Experts Group 

PNG Portable Network Graphics 

PBM Portable Bitmap 

PGM Portable Graymap 

PPM Portable Pixmap 

XBM X11 Bitmap 

XPM Xx11 Pixmap 


Following methods are useful in handling QPixmap object: 


Sr.No. Methods €: Description 


A copy() 
Copies pixmap data from a QRect object 
fromImage() 

j Converts QlImage object into QPixmap 
grabWidget() 

j Creates a pixmap from the given widget 
grabWindow() 

Ñ Create pixmap of data in a window 

5 Load() 
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Loads an image file as pixmap 


save() 


Saves the QPixmap object as a file 


tolmage 


Converts a QPixmap to QlImage 


The most common use of QPixmap is to display image on a label/button. 


Example 


The 


following example shows an ¡image displayed on a  QLabel 


the setPixmap() method. 


The complete code is as follows: 


by 


PyQt 


using 


if 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QthWidgets import * 


def window(): 


app = QApplication(sys.argv) 

win = QWidget() 

11 = QLabel() 
11.setPixmap(QPixmap("python.png")) 


vbox = QVBoxLayout() 
vbox.addWidget(11) 
win.setLayout(vbox) 
win.setWindowTitle("QPixmap Demo") 
win.show() 
sys.exit(app.exec_()) 
_ Nname_ =="  main_': 


window( ) 


The above code produces the following output: 
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